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选项卡。

1. 激活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个步骤：

MCP Screenshot

6.在Cursor中与MCP代理聊天

• 切换到代理模式:

- 在Cursor中激活代理模式，而不是标准聊天。

• 聊天时，Cursor将根据需要使用您的MCP工具（world_mini_app_query_tool）获取world MiniApp文档。

1. 记得用克劳德·十四行诗

- 特别是“claude-3.7连接器思考”型号

1. 从Anthropic获取API密钥:

- 首选 https://console.anthropic.com/ - 创建个人资料 - 获得API密钥放入信用，10美元是一个很好的金额来测试和用于构建您的迷你应用程序（记住Claude 3.7有更多的代币使用）

1. 打开光标设置:

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

图像支持3个步骤：

Models Screenshot

（可选）使用MCP检查员进行测试

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

npm install -g @modelcontextprotocol/inspector
mcp-inspector