AI Docs MCP

知识中心

A. 模型上下文协议（MCP）服务器 它为人工智能助手提供了跨多个平台对组织知识的统一访问。该服务器弥合了人工智能工具和组织知识库之间的差距，实现了跨本地文档、Guru和Notion的智能文档创建、检索和管理。

🚀 这是什么？

知识中心是一个生产就绪的MCP服务器，提供：

• 🧠 Guru知识库集成 -搜索、阅读和管理大师卡和收藏
• 📝 数据库管理概念 -在Notion数据库中创建、查询、更新和管理文档
• 🔍 高级查询和搜索 -跨所有平台的强大过滤、排序和搜索功能
• 🛠️ 内容创建和管理 -使用适当的元数据和代码块验证将markdown转换为Notion页面
• 🔄 双向同步 -将Notion页面导出回markdown格式
• 🏗️ 开发与生产模式 -针对不同环境的灵活部署选项

🏗️ 建筑

内置于 Types/Node.js (≥20.0.0), MCP SDK v1.12.0，以及 Zod验证 为了确保类型安全。具有干净、模块化的架构，关注点分开：

src/
├── index.ts              # Main MCP server entry point
├── server.ts             # Server configuration and tool registration
├── services/             # API services (Notion, Guru)
├── tools/                # MCP tool implementations
├── types/                # TypeScript type definitions
└── utils/                # Conversion utilities and helpers

🛠️ 可用工具（共9个）

🧠 Guru知识库（3个工具）

• guru-list-cards -使用高级查询搜索和过滤大师卡
• guru-read-card -读取带有格式的完整卡片内容
• guru-get-card-attachments -列出并下载卡片附件

📝 Notion数据库管理（5个工具）

• list-database-pages -高级查询和搜索，按类别、标签、状态过滤
• create-page-from-markdown -使用元数据和代码块验证从markdown创建页面
• update-page -更新现有页面（内容和/或元数据）
• archive-page -通过移动到垃圾箱来存档页面
• export-page-to-markdown -将页面导出为干净的markdown格式

🔧 实用工具（1个工具）

• hello -演示MCP功能的示例工具

⚙️ 配置和设置

🚀 安装

# Clone and install
git clone https://github.com/LaserFocused-ee/ai-docs-mcp.git
cd ai-docs-mcp/mcp_server
npm install

# Development
npm run dev

# Production build
npm run build && npm start

🔗 Claude桌面集成

开发配置

{
  "mcpServers": {
    "ai-knowledge-hub-dev": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "NODE_ENV": "development",
        "DEV_HOME": "/path/to/your/mcp_server",
        "GURU_TOKEN": "username:token",
        "NOTION_TOKEN": "your-notion-token",
        "NOTION_MCP_DATABASE_ID": "your-database-id"
      }
    }
  }
}

生产配置

{
  "mcpServers": {
    "ai-knowledge-hub": {
      "command": "npx",
      "args": ["ai-knowledge-hub"],
      "env": {
        "GURU_TOKEN": "username:token",
        "NOTION_TOKEN": "your-notion-token",
        "NOTION_MCP_DATABASE_ID": "your-database-id"
      }
    }
  }
}

🔑 API证书

大师：登录Guru→ 设置→ API访问→ 生成令牌→ 格式为 username:token

概念首选 概念整合 → 创建集成→ 获取API密钥→ 通过集成共享数据库→ 从URL复制数据库ID

📁 文档结构

当地文件整理 docs/ 目录：

docs/
├── code_guidelines/
│   ├── flutter/architecture/    # Flutter architecture patterns
│   ├── react/                   # React best practices
│   ├── nestjs/                  # NestJS guidelines
│   └── git/                     # Git workflows
└── service-docs/                # API guides and references

🌟 主要特点

📄 降价↔ 概念转换

• 代码块验证：根据Notion的2000个字符限制自动验证代码块
• 智能错误处理：为在保留逻辑边界的同时拆分大型代码块提供具体指导
• 丰富的格式支持：表、列表、标题、链接、代码块等
• 元数据保存：类别、标签、描述和状态值

🔍 高级查询系统

• 多平台搜索：跨本地文档、Guru和Notion的统一搜索
• 智能过滤：按类别、标签、状态、日期灵活排序进行筛选
• 分页支持：高效处理大型数据集

🛠️ 开发支持

• 环境检测：自动切换开发/生产模式
• 热重新加载：带文件监视的开发模式
• MCP检查器集成：全面的测试工具
• 类型安全：带有Zod验证的完整TypeScript

🧪 测试与验证

快速测试

# Interactive UI testing
npm run inspect

# Basic validation
npm run validate

# Comprehensive test suite
npm run test:inspector

工具调用示例

# List available documentation
npx @modelcontextprotocol/inspector --cli node dist/index.js \
  --method tools/call --tool-name legacy-list-docs

# Search Notion pages
npx @modelcontextprotocol/inspector --cli node dist/index.js \
  --method tools/call --tool-name list-database-pages \
  --tool-arg search="testing" --tool-arg limit=5

# Search Guru knowledge
npx @modelcontextprotocol/inspector --cli node dist/index.js \
  --method tools/call --tool-name guru-list-cards \
  --tool-arg searchTerms="API documentation" --tool-arg maxResults=5

💡 使用模式

当地文件

legacy-list-docs()  # Discover available docs
legacy-read-doc(category="code_guidelines/flutter", name="best-practices")

理念管理

# Context-aware search
list-database-pages(search="testing", tags=["react"], status="published")

# Create with metadata
create-page-from-markdown(
  markdown="# API Guide\n\nDocumentation...",
  metadata={category: "api-reference", tags: ["api", "rest"]}
)

大师知识访问

guru-list-cards(searchTerms="troubleshooting", maxResults=10)
guru-read-card(cardId="card-uuid")

🚀 发布与出版

此软件包使用自动化的GitHub Actions工作流进行专业的发布管理。

📦 对于用户

• 安装最新稳定版本： npx ai-knowledge-hub
• 查看所有版本：
• 检查npm版本：

🛠️ 供贡献者/维护者使用

• 自动发布：使用GitHub Actions进行安全、经过验证的发布
• 版本管理：支持语义版本控制（补丁/次要/主要）
• 质量保证：发布前自动测试和验证

📋 完整设置指南：参见 RELEASE_SETUP.md 有关以下内容的完整说明：

• 设置npm代币和GitHub机密
• 使用自动发布工作流
• 理解语义版本控制
• 常见问题排查

🔒 安全和要求

• Node.js：要求≥20.0.0
• 安全凭据：仅环境变量处理
• 文件访问：仅限于文档目录
• 输入验证：所有参数的Zod模式验证
• API速率限制：自动处理

📄 许可证

MIT许可证-有关详细信息，请参阅package.json。

______________________________________________________________________

知识中心将静态文档、机构知识和内容管理转化为人工智能助手的智能、可查询的生态系统。它能够提供基于上下文的开发指导、全面的文档管理，并通过统一、强大的API跨多个平台无缝访问您组织的集体知识。