MiniApp文档查询服务

一个集成了Cursor的MCP服务器,用于查询World MiniApps文档并辅助开发。

  • by Livus-AI
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 0xZap/WorldMiniApp_MCP

使用说明

带游标的World MiniApps MCP服务器

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

想法

这个想法是让一个代理能够读取 MiniApps 的 文档,然后帮助您使用Cursor编写您的世界MiniApp。

先决条件

  • Python 3:从下载 python.org 或通过Homebrew安装:
    brew install python
    
  • 光标:已安装在您的系统上。

安装说明

1.设置Python环境

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

# Create a virtual environment
python3 -m venv .venv

# Activate the virtual environment
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

Obs.:Mateo(世界队)说你可以使用 https://docs.world.org/llms-full.txt 支持所有World Docs。

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

4.运行MCP服务器

通过运行以下命令启动MCP服务器:

python3 worldMiniApp-MCP/miniApp_mcp.py

服务器通过stdio运行并等待MCP请求。

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

  1. 打开光标设置:

    • 在光标中,转到设置并单击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_mcp.py"
      ],
      "env": {
        "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
  • 替换 "your-openai-api-key" 使用您的实际API密钥。
  1. 保存配置:
    • Cursor现在将检测您的MCP服务器。

图像支持3个步骤:

6.在Cursor中与MCP代理聊天

  • 切换到代理模式:
    • 在Cursor中激活代理模式,而不是标准聊天。
  • 聊天时,Cursor将根据需要使用您的MCP工具(world_mini_app_query_tool)获取world MiniApp文档。
  1. 记得用克劳德·十四行诗

    • 特别是“claude-3.7连接器思考”型号
  2. 从Anthropic获取API密钥:

    • 首选 https://console.anthropic.com/
    • 创建个人资料
    • 获得API密钥放入信用,10美元是一个很好的金额来测试和用于构建您的迷你应用程序(记住Claude 3.7有更多的代币使用)
  3. 打开光标设置:

    • 在光标中,转到设置,然后单击模型选项卡。
    • 选择克劳德模型
    • 把你的选集API密钥

图像支持3个步骤:

(可选)使用MCP检查员进行测试

要手动检查MCP服务器,请安装并运行MCP Inspector:

npm install -g @modelcontextprotocol/inspector
mcp-inspector