Vercel AI SDK 文档 MCP 代理

Vercel AI SDK 文档 MCP 代理 是一个用于查询和合成 Vercel AI SDK 文档信息的工具集。以下是完整的项目文档。

概述

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

1. agent-query：使用 AI 代理进行文档信息检索和总结。
2. direct-query：直接对文档内容进行相似度搜索。
3. clear-memory：清除特定会话或所有会话的上下文记忆。

功能特点

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

架构组件

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

安装说明

环境要求

• 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
   

集成指南

与 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",