Lallen30 MCP Remote Server

🚀 BluestoneApps MCP 远程服务器

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

🚀 快速开始

安装配置

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 服务器的资源目录：

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：列出所有可用的代码示例按类别。