Documentation Hub MCP 服务器

一个用于跨多个技术领域进行智能文档检索的模型上下文协议 (MCP) 服务器。

概述

本项目实现了一个 MCP 服务器，为技术查询提供有针对性的文档检索。它使用混合方法来：

1. 确定查询的技术领域（React、Node.js、Python）
2. 从查询中提取特定主题
3. 构建精确的文档 URL
4. 获取并返回最相关的文档

该服务器使用 TypeScript 和 MCP SDK 构建，为 AI 模型提供了一个访问文档资源的标准化接口。

特性

• 领域分类: 自动识别查询是关于 React、Node.js、Python 还是通用主题
• 主题提取: 使用正则表达式模式匹配来识别查询中的特定技术概念
• URL 构建: 基于识别的主题构建有针对性的文档 URL
• 多文档来源: 支持来自 React、Node.js、Python 的文档，并且可以扩展到其他领域
• 标准化接口: 实现模型上下文协议，以便与 MCP 兼容的客户端进行互操作

安装

# 克隆仓库
git clone https://github.com/yourusername/mcp-server.git
cd mcp-server

# 安装依赖
npm install

# 构建项目
npm run build

使用

运行服务器

node build/index.js

测试主题提取

该项目包含一个测试脚本，用于演示主题提取和 URL 构建的工作方式：

# 构建测试脚本
npx tsc src/test.ts --outDir build

# 运行测试
node build/test.js

与客户端集成

该服务器可以与任何 MCP 兼容的客户端集成。以下是一个客户端如何与服务器交互的示例：

// 示例客户端代码（不包含在此项目中）
const client = new McpClient();
const result = await client.callTool("fetch-documentation", {
  query: "How do I use useState hook in React?",
});

console.log(result);
// 输出: {
//   domain: "react-docs",
//   topics: ["useState", "state"],
//   specificUrl: "https://react.dev/reference/react/useState",
//   content: "...",
//   source: "https://react.dev/reference/react/useState"
// }

项目结构

• src/index.ts - 主要服务器实现
• src/test.ts - 用于主题提取和 URL 构建的测试脚本
• build/ - 编译后的 JavaScript 输出
• package.json - 项目配置和依赖项

可用工具

服务器公开以下工具：

determine-domain

确定查询属于哪个技术领域。

{
  query: string; // 要分类的用户查询
}

返回:

{
  domain: string; // 识别的领域
  confidence: string; // "high" 或 "low"
}

extract-topics

从给定领域的查询中提取特定主题。

{
  query: string; // 要分析的用户查询
  domain: string; // 要提取主题的技术领域
}

返回:

{
  topics: string[]; // 识别的主题数组
  count: number; // 找到的主题数量
}

fetch-documentation

根据查询和领域获取文档。

{
  query: string; // 用户查询
  domain?: string; // 可选的领域覆盖
}

返回:

{
  domain: string; // 识别的领域
  topics: string[]; // 识别的主题数组
  specificUrl: string | null; // 如果可用，则为构建的 URL
  content: string; // 获取的文档内容
  source: string; // 源 URL
}

可用资源

服务器提供以下文档资源：

• react-docs - React.js 文档
• node-docs - Node.js 文档
• python-docs - Python 文档
• general - 领域不明确时的通用文档

扩展服务器

添加新领域

要添加对新技术领域的支持：

1. 将领域关键字添加到 determineDomain 函数中的 domainKeywords 对象
2. 将主题模式添加到 extractTopics 函数中的 topicPatterns 对象
3. 将 URL 构建逻辑添加到 constructSpecificUrl 函数
4. 在服务器配置中添加新的资源处理程序

改进主题提取

可以通过以下方式改进主题提取：

1. 增强现有主题的正则表达式模式
2. 将新主题添加到现有领域
3. 实施更复杂的 NLP 技术进行主题提取

许可证

MIT

贡献

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