BluestoneApps MCP 远程服务器

此服务器通过 HTTP 实现了模型上下文协议 (MCP)，允许远程访问 BluestoneApps 编码标准和代码示例。

功能

• 通过 HTTP 使用 JSON-RPC 2.0 实现 MCP 协议
• 支持服务器发送事件 (SSE) 以进行流式响应
• 提供对编码标准和代码示例的访问
• 支持身份验证
• Docker 部署就绪
• 通过域名支持 HTTPS：https://mcp.betaplanets.com

设置

1. 安装依赖项：

pip install -r requirements.txt

2. 通过编辑 .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

3. 从本地 MCP 服务器复制 resources 目录：

cp -r ../mcp-server/resources ./

本地运行

python simple_mcp_server.py

测试

本地测试

# 启动服务器
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 hook 示例
• get_service_example: 获取一个 React Native 服务示例
• get_screen_example: 获取一个 React Native 屏幕示例
• get_theme_example: 获取一个 React Native 主题示例
• list_available_examples: 按类别列出所有可用的代码示例