World ID And MiniApps Documentation

🚀 項目標題 - 構建MCP服務器以集成World Mini Apps文檔與Cursor

本項目專注於搭建一個MCP服務器，其核心功能在於查詢World Mini Apps文檔，並將該功能與Cursor進行集成。藉助此服務器，開發者在使用Cursor編寫World MiniApp時，能夠更高效地獲取文檔信息，提升編碼效率。

🚀 快速開始

本項目旨在創建一個可閱讀MiniApps文檔的代理，在使用Cursor編寫World MiniApp時為編碼提供助力。

✨ 主要特性

• 構建MCP服務器，實現對World Mini Apps文檔的查詢功能。
• 與Cursor集成，在編碼過程中提供文檔支持。
• 藉助代理幫助開發者更高效地編寫World MiniApp。

📦 安裝指南

先決條件

• 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

該服務器將在標準輸入輸出上運行，並等待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_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文檔。

7. 模型相關設置

1. 記得使用Claude Sonnet：特別是模型“claude-3.7-sonnet-thinking”。
2. 獲取Anthropic的API密鑰：
   • 前往https://console.anthropic.com/。
   • 創建個人資料。
   • 獲取API密鑰（建議充值10美元用於測試和構建你的MiniApp，因為Claude 3.7的使用量更大）。
3. 打開Cursor設置：
   • 在Cursor中，轉到“設置”並點擊“模型”選項卡。
   • 選擇Claude模型。
   • 輸入你的Anthropic API密鑰。

圖片支持步驟如下：

（可選）使用MCP Inspector測試

要手動檢查你的MCP服務器，安裝並運行MCP Inspector：

npm install -g @modelcontextprotocol/inspector
mcp-inspector