World MiniApps MCP 服务器与 Cursor 集成

该项目设置了一个 MCP 服务器来查询 World Mini Apps 文档，并将其与 Cursor 集成。

概念

该概念是创建一个能够读取 MiniApps 文档的代理，然后帮助你在 Cursor 中编写你的世界迷你应用。

预备条件

• Python 3: 从 python.org 下载或通过 Homebrew 安装：

  brew install python
  

• Cursor: 已安装在你的系统上。

设置指南

1. 设置 Python 环境

打开终端并运行以下命令：

# 创建虚拟环境
python3 -m venv .venv

# 激活虚拟环境
source .venv/bin/activate

2. 安装依赖项

激活虚拟环境后，安装所需的包：

pip install langchain_community langchain-openai langchain-anthropic scikit-learn bs4 pandas pyarrow matplotlib lxml langgraph "mcp[cli]" tiktoken

3. 构建文档向量存储

在运行构建脚本之前，在终端中导出你的 OpenAI API 密钥：

export OPENAI_API_KEY="your-openai-api-key"

然后，运行：

python3 worldMiniApp-MCP/miniApp_build_docs.py

备注：Mateo（World 团队）表示你可以使用 https://docs.world.org/llms-full.txt 来支持所有 World 文档。

此脚本将创建 llms_full.txt 和 sklearn_vectorstore.parquet 文件。

4. 运行 MCP 服务器

启动你的 MCP 服务器：

python3 worldMiniApp-MCP/miniApp_mcp.py

服务器通过标准 I/O 运行，并等待 MCP 请求。

5. 配置 Cursor 使用你的 MCP 服务器

1. 打开 Cursor 设置：

   • 在 Cursor 中，进入设置并点击 MCP 标签页。

2. 激活 MCP 并添加配置：

   • 将下面的 JSON 复制粘贴到 MCP 配置区域：

{
  "mcpServers": {
    "world-mini-app-mcp": {
      "command": "your-absolute-path-to-repo-folder/WorldMCP/.venv/bin/python",
      "args": [
        "your-absolute-path-to-repo-folder/WorldMCP/worldMiniApp-MCP/miniApp_m_ mcp.py"
      ],
      "env": {
        "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

• 将 "your-openai-api-key" 替换为你实际的 API 密钥。

3. 保存配置：
   • Cursor 将检测到你的 MCP 服务器。

步骤图像支持：

6. 在 Cursor 中与 MCP 代理聊天

• 切换到代理模式：
  • 不使用标准聊天，而是激活 Cursor 中的代理模式。
• 当你聊天时，Cursor 将使用你的 MCP 工具（world_mini_app_query_tool）根据需要获取 World MiniApp 文档。

1. 记得使用 Claude Sonnet

   • 特别是模型 "claude-3.7-sonnet-thinking"

2. 从 Anthropic 获取 API 密钥：

   • 访问 https://console.anthropic.com/
   • 创建个人资料
   • 添加信用以获取 API 密钥，10 美元是一个测试和构建迷你应用的好金额（注意 Claude 3.7 的令牌使用更多）

3. 打开 Cursor 设置：

   • 在 Cursor 中，进入设置并点击模型标签页。
   • 选择 Claude 模型
   • 输入你的 Anthropic API 密钥

步骤图像支持：

（可选）使用 MCP Inspector 测试

要手动检查你的 MCP 服务器，请安装并运行 MCP Inspector：

npm install -g @modelcontextprotocol/inspector
mcp-inspector