Knowledge Graph Driven Project Management MCP

任务指南 MCP 服务器

一个用于提升AI代理任务性能的MCP（模型上下文协议）服务器。它通过提供任务区域划分、层次化RAG（检索增强生成）以及混合搜索功能，解决了随着项目规模扩大而出现的AI性能下降问题。

主要特点

1. 指导管理

• 创建指导（或：生成指导方针）创建一个新的任务指南
• 更新指导方针更新现有指南
• 指导列表列出所有指南
• 获取指导检索特定指南
• 删除指导（或“删除指南”）删除一条指南

2. 分层RAG（Retrieval-Augmented Generation，检索增强生成）

• 在分层结构（目录、文件、函数、类）中索引代码库
• 从高级概念到详细信息的逐步探索
• 根据所需的抽象级别，动态地结合相关上下文

3. 混合搜索

• 结合向量（语义）搜索与结构化索引
• 基于关系的知识图谱搜索
• 结合高精度证据、代码和决策历史

4. 索引与搜索

• 索引引导为指南对代码库和文档进行索引
• 搜索执行混合搜索
• 构建层级结构构建代码库的层次结构

安装与执行

1. 安装依赖项

npm install

2. 构建

npm run build

3. 开发模式

npm run dev

4. 生产执行

npm start

使用方法

MCP客户端配置

在您的MCP客户端中将服务器配置如下：

{
  "mcpServers": {
    "task-guide": {
      "command": "node",
      "args": ["/path/to/task-guide-mcp/dist/index.js"]
    }
  }
}

指导创建示例

// Create a new guidance
await mcp.callTool('create_guidance', {
  title: 'React Component Development',
  objective: 'Develop reusable React components',
  technicalConstraints: [
    'Use TypeScript',
    'Use only functional components',
    'Tailwind CSS styling'
  ],
  workRules: [
    'Components follow single responsibility principle',
    'Props defined with interfaces',
    'Storybook documentation required'
  ],
  completionCriteria: [
    'Component functions correctly',
    'No TypeScript errors',
    'Storybook stories completed'
  ],
  tags: ['react', 'typescript', 'component'],
  priority: 'high'
});

搜索示例

// Hybrid search
const results = await mcp.callTool('search', {
  query: 'React component',
  type: 'code',
  limit: 5,
  threshold: 0.7
});

项目结构

task-guide-mcp/
├── src/
│   ├── types/
│   │   └── index.ts              # Type definitions
│   ├── core/
│   │   ├── guidance-manager.ts   # Guidance management
│   │   ├── hierarchical-rag.ts   # Hierarchical RAG
│   │   └── hybrid-search.ts      # Hybrid search
│   └── index.ts                  # MCP server main
├── guidance/                     # Guidance repository
│   ├── {guidance-id}/
│   │   └── summary.json         # Guidance summary
│   └── metadata/
│       └── {guidance-id}.vec    # Metadata vector
├── data/
│   └── search.db                # Search database
├── package.json
├── tsconfig.json
└── README.md

技术栈

• TypeScript类型安全
• @modelcontextprotocol/sdk（注：这个表述在中文中可能不太常见，因为它看起来像是一个特定框架或库的命名，直接翻译可能无法准确传达其含义，但根据字面意思，可以翻译为“@模型上下文协议/开发工具包”，不过具体翻译还需根据该SDK的实际用途和上下文来确定。）MCP协议实现
• better-sqlite3（可译为“增强版SQLite3”或根据具体语境译为“更优的SQLite3实现”，但通常直接保留原名以指明其特性）向量和结构索引存储
• OpenAI API嵌入生成（未来实施）
• 分层RAG（Retrieval-Augmented Generation，检索增强生成）代码库结构分析
• 混合搜索向量+结构搜索

许可证

麻省理工学院许可证（MIT License）