文策尔人工智能文档MCP服务器

Name: 文策尔人工智能文档MCP服务器
Author: IvanAmador

作者：IvanAmador41 星标更新：2025-04-05

安装使用来源：spider==github.com

项目介绍

Vercel AI SDK 文档 MCP 代理

这是一个基于模型上下文协议（MCP）的服务器，为Vercel AI SDK文档提供基于人工智能的搜索和查询能力。该项目使开发者能够就Vercel AI SDK提出问题，并根据官方文档获得准确且具有上下文的回答。

特性

直接文档搜索：通过相似度搜索直接查询Vercel AI SDK文档索引
基于AI的代理：就Vercel AI SDK提出自然语言问题并获得全面的回答
会话管理：在多个查询之间维护对话上下文
自动索引：包括获取、处理和索引最新Vercel AI SDK文档的工具

架构

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

MCP 服务器：通过模型上下文协议暴露工具以集成到AI助手中
文档抓取器：爬取并处理Vercel AI SDK文档
向量存储管理器：创建和管理用于语义搜索的FAISS向量索引
代理服务：使用Google Gemini模型提供基于AI的答案
直接查询服务：提供对文档的直接语义搜索

安装指南

预备条件

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

环境变量

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

GOOGLE_GENERATIVE_AI_API_KEY=your-google-api-key-here

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

安装步骤

克隆仓库

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

安装依赖
```
npm install
```
构建项目
```
npm run build
```
构建文档索引
```
npm run build:index
```
启动MCP服务器
```
npm run start
```

与Claude Desktop集成

Claude Desktop是一款支持MCP服务器的强大AI助手。要连接Vercel AI SDK文档MCP代理与Claude Desktop：

如果尚未安装，请先安装Claude Desktop。
打开Claude Desktop设置（通过应用程序菜单，而不是聊天界面内的菜单）。
导航至“开发者”标签页并点击“编辑配置”。
将Vercel AI文档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密钥

保存配置文件并重启Claude Desktop。
要验证服务器是否已连接，请查看Claude聊天界面中的锤子🔨图标。

更多关于如何使用Claude Desktop设置MCP服务器的信息，请参阅MCP快速入门指南。

与其他MCP客户端集成

此MCP服务器兼容任何实现模型上下文协议的客户端。这里有几个例子：

Cursor

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

在您的项目目录中添加一个.cursor/mcp.json文件（用于特定项目的配置），或在您的主目录中添加一个~/.cursor/mcp.json文件（用于全局配置）。
在您的配置文件中添加以下内容：

{
  "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"
      }
    }
  }
}

有关如何使用Cursor中的MCP的更多信息，请参阅Cursor MCP文档。

使用方法

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

1. agent-query

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

{
  "name": "agent-query",
  "arguments": {
    "query": "如何使用streamText函数？",
    "sessionId": "unique-session-id"
  }
}

2. direct-query

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

{
  "name": "direct-query",
  "arguments": {
    "query": "streamText用法",
    "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: 开发模式构建和启动

故障排除

常见问题

索引未找到或加载失败

在启动服务器之前运行npm run build:index以创建索引。
API速率限制

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

确保您的Google API密钥有效，并有权访问指定的Gemini模型。
Claude Desktop未显示MCP服务器
- 检查配置文件是否有语法错误。
- 确保服务器路径正确且是绝对路径。
- 查看Claude Desktop日志中的错误。
- 在更改配置后重启Claude Desktop。

贡献

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

许可证

MIT