Vercel Ai Docs MCP

🚀 Vercel AI SDK 文檔 MCP 代理

Vercel AI SDK 文檔 MCP 代理 是一個用於查詢和合成 Vercel AI SDK 文檔信息的工具集，能幫助用戶高效獲取所需文檔內容。

🚀 快速開始

該項目提供了一個基於模型上下文協議（MCP）的服務器，支持通過智能代理和直接搜索來查詢 Vercel AI SDK 文檔。

✨ 主要特性

• 支持多輪對話上下文，便於複雜問題的解決。
• 提供靈活的查詢參數（如限制結果數量）以滿足不同需求。
• 內置文檔索引功能，支持快速檢索和加載。
• 支持會話管理，確保每次交互獨立且可追溯。

📦 安裝指南

環境要求

• Node.js（版本 14 或更高）
• TypeScript（版本 4.0 或更高）

安裝步驟

1. 克隆項目倉庫：

git clone [REPOSITORY_URL]
cd Vercel-AI-SDK-Documentation-MCP-Agent

2. 安裝依賴：

npm install

3. 編譯代碼：

npm run build

4. 構建文檔索引（首次使用必做）：

npm run build:index

📚 詳細文檔

架構組件

├── config/            # 配置文件夾
├── core/              # 核心功能模塊
│   ├── indexing/      # 文檔索引與向量存儲
│   └── query/         # 查詢服務（代理和直接）
├── files/             # 存儲目錄
│   ├── docs/          # 處理後的文檔
│   ├── faiss_index/   # 向量索引文件
│   └── sessions/      # 會話數據
├── mcp/               # MCP 服務器與工具
│   ├── server.ts       # MCP 服務器實現
│   └── tools/          # MCP 工具定義
├── scripts/           # 構建與工具腳本
└── utils/             # 輔助工具函數

集成指南

與 Claude Desktop 集成

1. 在 ~/.config/claude 目錄下創建或編輯 mcp-config.json 文件，添加以下內容：

{
  "tools": [
    {
      "name": "Vercel-AI-SDK-Documentation-MCP-Agent",
      "path": "/absolute/path/to/server"
    }
  ]
}

2. 啟動 Claude Desktop 並驗證工具是否生效。

與 Cursor 集成

1. 在項目根目錄下創建或編輯 mcp-config.json 文件，添加以下內容：

{
  "tools": [
    {
      "name": "Vercel-AI-SDK-Documentation-MCP-Agent",
      "path": "/absolute/path/to/server"
    }
  ]
}

2. 重啟 Cursor 應用以加載配置。

💻 使用示例

基礎用法

1. agent-query

通過 AI 代理查詢文檔信息：

{
  "name": "agent-query",
  "arguments": {
    "query": "如何使用 streamText 函數？",
    "sessionId": "唯一會話標識符"
  }
}

2. direct-query

直接對文檔內容進行相似度搜索：

{
  "name": "direct-query",
  "arguments": {
    "query": "streamText 使用方法",
    "limit": 5
  }
}

3. clear-memory

清除特定會話或所有會話的上下文記憶：

{
  "name": "clear-memory",