🚀 BluestoneApps MCP 远程服务器
本服务器借助 HTTP 实现模型上下文协议 (MCP)，能够让用户对 BluestoneApps 编码标准和代码示例进行远程访问，为开发者提供便捷的资源获取途径。
🚀 快速开始
安装配置
- 安装依赖项：
pip install -r requirements.txt
- 通过编辑
.env文件配置服务器：
MCP_TRANSPORT=http
MCP_HOST=0.0.0.0
MCP_PORT=8000
MCP_AUTH_ENABLED=true
MCP_AUTH_USERNAME=mcp-server
MCP_AUTH_PASSWORD=n2hXUijptRwpe9v6wZ37yOgEx4P8w3ofDRO0ko4A
- 复制本地 MCP 服务器的资源目录：
cp -r ../mcp-server/resources ./
本地运行
python simple_mcp_server.py
✨ 主要特性
- 通过 HTTP 实现 MCP 协议，采用 JSON - RPC 2.0 技术。
- 支持服务器发送事件 (SSE) 进行流式响应，实现高效的数据传输。
- 提供编码标准和代码示例的访问权限，助力开发者快速获取所需资源。
- 支持身份验证，保障系统的安全性。
- 支持 Docker 部署，方便进行环境搭建和迁移。
- 支持 HTTPS，通过域名
https://mcp.betaplanets.com访问。
📦 安装指南
安装依赖
pip install -r requirements.txt
配置服务器
编辑 .env 文件：
MCP_TRANSPORT=http
MCP_HOST=0.0.0.0
MCP_PORT=8000
MCP_AUTH_ENABLED=true
MCP_AUTH_USERNAME=mcp-server
MCP_AUTH_PASSWORD=n2hXUijptRwpe9v6wZ37yOgEx4P8w3ofDRO0ko4A
复制资源目录
cp -r ../mcp-server/resources ./
💻 使用示例
本地测试
# 启动服务器
python simple_mcp_server.py
# 在另一个终端，运行测试脚本
./test_mcp_server.sh
远程测试
# 测试远程服务器（IP 地址）
./test_remote_server.sh
# 测试域名
./test_domain.sh
Docker 部署
# 构建并推送 Docker 镜像
./build_and_push.sh
# 部署到远程服务器
./deploy.sh
📚 详细文档
与 Windsurf/Cascade 连接
在 MCP 配置文件 (~/.codeium/windsurf/mcp_config.json) 中添加以下内容：
{
"mcpServers": {
"bluestoneapps-remote": {
"transport": "http",
"url": "http://your-server-ip:5051",
"headers": {
"Authorization": "Basic YWRtaW46Y2hhbmdlbWU="
},
"description": "BluestoneApps 编码标准和示例（远程）",
"displayName": "BluestoneApps 开发标准（远程）"
}
}
}
注意：Authorization 头是 base64(username:password)。对于默认凭据（admin:changeme），这是 YWRtaW46Y2hhbmdlbWU=。
可用工具
get_project_structure：获取 React Native 开发的项目结构标准。get_api_communication：获取 React Native 开发的 API 通信标准。get_component_design：获取 React Native 组件设计标准。get_state_management：获取 React Native 状态管理标准。get_component_example：获取 React Native 组件示例。get_hook_example：获取 React Native 钩子示例。get_service_example：获取 React Native 服务示例。get_screen_example：获取 React Native 屏幕示例。get_theme_example：获取 React Native 主题示例。list_available_examples：列出所有可用的代码示例按类别。