🚀 BluestoneApps MCP 远程服务器

该服务器借助 HTTP 实现模型上下文协议 (MCP)，可对 BluestoneApps 编码标准和代码示例进行远程访问，为开发者提供便捷的资源获取途径。

✨ 主要特性

• 通过 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

测试

本地测试

# 启动服务器
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=。

📚 详细文档

可用工具