使用说明
任务和回购审计员：MCP服务器（Deep Dive PoC）
该项目是一个基于构建的高性能模型上下文协议（MCP）服务器。网9。它演示了如何将标准的Web API转换为能够实时编排任务和审核GitHub存储库的AI驱动代理。
特性
1.任务API
一个强大的最小API作为任务管理的后端：
- 完整CRUD：创建、读取、更新和删除任务。
- 智能过滤器：按关键字搜索任务并识别逾期项目。
- 内存存储：轻量级的、基于零配置列表的数据库。
- 通知系统：用于跟踪任务生命周期事件的内部端点。
2.MCP服务器功能
将AI意图转化为代码执行的核心引擎：
- 多客户端集成：与本地Task API和GitHub REST API同时通信。
- AI提示：“日常计划”和“存储库审计”的预定义模板
- 高级日志记录：清理stderr日志记录，以确保调试期间的协议稳定性。
项目结构
- /任务。Api-后端服务（端口：7376）。
- /任务。McpServer-使用最新ModelContextProtocol SDK的MCP网关。
- ApiClients：为Tasks和GitHub优化了HttpClient实现。
- 工具：提供给AI的“技能”（CRUD+回购同步）。
- 提示：LLM要遵循的结构化工作流程。
MCP工具目录
任务工具
| 工具名称 | 描述 |
|---|---|
GetAllTasksAsync |
获取完整的工作负载概览。 |
SearchTasksAsync |
使用语义关键字查找任务。 |
CreateTaskAsync |
向系统添加新任务。 |
UpdateTaskAsync |
修改现有任务（状态、标题等）。 |
DeleteTaskAsync |
按ID删除任务 |
GetOverdueTasksAsync |
隔离紧急、逾期的项目。 |
GitHub和集成工具
| 工具名称 | 描述 |
|---|---|
GetLatestIssuesAsync |
从任何公共回购中获取已过滤的未结问题（不包括PR）。 |
GetRepoStatsAsync |
返回回购健康指标（星级、未结问题计数）。 |
SyncLatestIssuesToTasksAsync |
Orchestrator工具：自动从GitHub获取最重要的问题，并在本地API中创建相应的任务。 |
AI提示（工作流）
daily-planner：指示AI分析所有任务，识别逾期项目，并为用户建议一个三点优先级列表。auto-sync-repo：一个专门的代理工作流，可以审计特定的存储库，并一键将最新问题同步到本地任务数据库中。
MCP资源
| 资源名称 | 描述 |
|---|---|
GitHub Repository README |
获取GitHub存储库的README文件。 |
配置和安装
要将此服务器与Claude Desktop或任何兼容MCP的IDE一起使用，请将以下内容添加到您的配置文件中（例如，%APPDATA%\Labs\Claude\Claude_Desktop_config.json）：
{
"inputs": [],
"servers": {
"TasksMcpServer": {
"type": "stdio",
"command": "dotnet",
"args": [
"run",
"--project",
"<YOUR-PROJECT-PATH>\\Tasks.McpServer\\Tasks.McpServer.csproj"
]
}
}
}
先决条件
- .NET 10 SDK
- （可选）GitHub个人访问令牌（用于更高的速率限制）。
Deep Dive：为什么这很重要？
此PoC说明了软件开发中的代理转变。MCP服务器允许AI充当桥梁，通过自然语言命令自动化数据流，而不是由开发人员手动检查GitHub问题并更新Jira/Task板。
