金大哥 - vercel-ai-docs-mcp MCP 详情

article

README

🚀 Vercel AI SDK 文档 MCP 代理

Vercel AI SDK 文档 MCP 代理 是一个用于查询和合成 Vercel AI SDK 文档信息的工具集，能有效帮助用户获取所需的文档内容。

🚀 快速开始

该项目提供了一个基于模型上下文协议（MCP）的服务器，支持通过智能代理和直接搜索来查询 Vercel AI SDK 文档。

✨ 主要特性

支持多轮对话上下文，便于复杂问题的解决。
提供灵活的查询参数（如限制结果数量）以满足不同需求。
内置文档索引功能，支持快速检索和加载。
支持会话管理，确保每次交互独立且可追溯。

🔧 技术细节

架构组件

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

📦 安装指南

环境要求

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

安装步骤

克隆项目仓库：

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

安装依赖：
```
npm install
```
编译代码：
```
npm run build
```
构建文档索引（首次使用必做）：
```
npm run build:index
```

📚 详细文档

集成指南

与 Claude Desktop 集成

在 ~/.config/claude 目录下创建或编辑 mcp-config.json 文件，添加以下内容：

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

启动 Claude Desktop 并验证工具是否生效。

与 Cursor 集成

在项目根目录下创建或编辑 mcp-config.json 文件，添加以下内容：

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

重启 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",
  // 此处原文档未完整，推测后续可能还有内容
}

vercel-ai-docs-mcp