Vercel AI SDK 文档 MCP 代理

一个模型上下文协议 (MCP) 服务器，为 Vercel AI SDK 文档提供 AI 驱动的搜索和查询功能。该项目使开发人员能够提出关于 Vercel AI SDK 的问题，并根据官方文档接收准确、上下文相关的回复。

特性

• 直接文档搜索: 使用相似性搜索直接查询 Vercel AI SDK 文档索引
• AI 驱动的代理: 提出关于 Vercel AI SDK 的自然语言问题，并接收全面的答案
• 会话管理: 在多个查询中保持对话上下文
• 自动索引: 包括获取、处理和索引最新 Vercel AI SDK 文档的工具

架构

该系统由几个关键组件组成：

1. MCP 服务器: 通过模型上下文协议公开工具，以便与 AI 助手集成
2. DocumentFetcher: 抓取和处理 Vercel AI SDK 文档
3. VectorStoreManager: 创建和管理用于语义搜索的 FAISS 向量索引
4. AgentService: 使用 Google Gemini 模型为问题提供 AI 驱动的答案
5. DirectQueryService: 提供对文档的直接语义搜索

安装说明

前提条件

• Node.js 18+
• npm
• 用于 Gemini 模型访问的 Google API 密钥

环境变量

在项目根目录中创建一个 .env 文件，包含以下变量：

GOOGLE_GENERATIVE_AI_API_KEY=your-google-api-key-here

您需要从 Google AI Studio 获取 Google Gemini API 密钥。

安装

1. 克隆存储库

   git clone https://github.com/IvanAmador/vercel-ai-docs-mcp.git
   cd vercel-ai-docs-mcp-agent
   

2. 安装依赖项

   npm install
   

3. 构建项目

   npm run build
   

4. 构建文档索引

   npm run build:index
   

5. 启动 MCP 服务器

   npm run start
   

与 Claude Desktop 集成

Claude Desktop 是一个强大的 AI 助手，支持 MCP 服务器。要将 Vercel AI SDK 文档 MCP 代理与 Claude Desktop 连接，请执行以下操作：

1. 首先，如果您还没有安装 Claude Desktop，请安装它。

2. 打开 Claude Desktop 设置（通过应用程序菜单，而不是在聊天界面中）。

3. 导航到“Developer”选项卡，然后单击“Edit Config”。

4. 将 Vercel AI Docs MCP 服务器添加到您的配置：

{
  "mcpServers": {
    "vercel-ai-docs": {
      "command": "node",  
      "args": ["ABSOLUTE_PATH_TO_PROJECT/dist/main.js"],
      "env": {
        "GOOGLE_GENERATIVE_AI_API_KEY": "your-google-api-key-here"
      }
    }
  }
}

请确保替换：

• ABSOLUTE_PATH_TO_PROJECT 为您的项目文件夹的实际路径
• your-google-api-key-here 为您的 Google Gemini API 密钥

5. 保存配置文件并重新启动 Claude Desktop。

6. 要验证服务器是否已连接，请在 Claude 聊天界面中查找锤子 🔨 图标。

有关使用 Claude Desktop 设置 MCP 服务器的更多详细信息，请访问 MCP 快速入门指南。

与其他 MCP 客户端集成

此 MCP 服务器与任何实现模型上下文协议的客户端兼容。以下是一些示例：

Cursor

Cursor 是一个 AI 驱动的代码编辑器，支持 MCP 服务器。要与 Cursor 集成：

1. 将 .cursor/mcp.json 文件添加到您的项目目录（用于项目特定的配置）或将 ~/.cursor/mcp.json 文件添加到您的主目录（用于全局配置）。

2. 将以下内容添加到您的配置文件：

{
  "mcpServers": {
    "vercel-ai-docs": {
      "command": "node",  
      "args": ["ABSOLUTE_PATH_TO_PROJECT/dist/main.js"],
      "env": {
        "GOOGLE_GENERATIVE_AI_API_KEY": "your-google-api-key-here"
      }
    }
  }
}

有关将 MCP 与 Cursor 结合使用的更多信息，请参阅 Cursor MCP 文档。

用法

MCP 服务器公开了三个主要工具：

1. agent-query

使用可以搜索和综合信息的 AI 代理查询 Vercel AI SDK 文档。

{
  "name": "agent-query",
  "arguments": {
    "query": "How do I use the streamText function?",
    "sessionId": "unique-session-id"
  }
}

2. direct-query

对 Vercel AI SDK 文档索引执行直接相似性搜索。

{
  "name": "direct-query",
  "arguments": {
    "query": "streamText usage",
    "limit": 5
  }
}

3. clear-memory

清除特定会话或所有会话的对话记忆。

{
  "name": "clear-memory",
  "arguments": {
    "sessionId": "unique-session-id"
  }
}

要清除所有会话，请省略 sessionId 参数。

开发

项目结构

├── config/              # 配置设置
├── core/                # 核心功能
│   ├── indexing/        # 文档索引和向量存储
│   └── query/           # 查询服务（代理和直接）
├── files/               # 存储目录
│   ├── docs/            # 已处理的文档
│   ├── faiss_index/     # 向量索引文件
│   └── sessions/        # 会话数据
├── mcp/                 # MCP 服务器和工具
│   ├── server.ts        # MCP 服务器实现
│   └── tools/           # MCP 工具定义
├── scripts/             # 构建和实用程序脚本
└── utils/               # 辅助实用程序

构建脚本

• npm run build: 编译 TypeScript 文件
• npm run build:index: 构建文档索引
• npm run dev:index: 在开发模式下构建和索引
• npm run dev: 在开发模式下构建和启动

故障排除

常见问题

1. 找不到索引或加载失败

   在启动服务器之前，运行 npm run build:index 以创建索引。

2. API 速率限制

   当超过 Google API 速率限制时，代理服务可能会返回错误。实施适当的回退策略。

3. 模型连接问题

   确保您的 Google API 密钥有效并且有权访问指定的 Gemini 模型。

4. Claude Desktop 不显示 MCP 服务器

   • 检查您的配置文件是否存在语法错误。
   • 确保服务器的路径正确且绝对。
   • 检查 Claude Desktop 日志是否存在错误。
   • 在进行配置更改后重新启动 Claude Desktop。

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

MIT