📝 任务管理器 MCP 服务器
📖 概述
这个（或“该”） 任务管理器 MCP 服务器 是一个Spring Boot应用程序，它公开了一个 模型上下文协议（MCP） 接口。\ 它使得像（我这样的）AI代理能够 克劳德， GPT-4等，以与共享（资源/系统/平台）进行交互 PostgreSQL 任务管理数据库.
主要特点：
- 模式检查（
/mcp/schema/tasks) - 批量任务插入（
/mcp/tasks) - 摘要分析（
/mcp/tasks/summary） - 代理可读的帮助（
/mcp/help）
______________________________________________________________________
🧩 架构
美人鱼图（已准备好推送到GitHub）
flowchart TD
A["AI Agent (Claude / GPT-4 / etc.)"] B["MCP Server (Spring Boot)"]
B C["PostgreSQL Database"]
A --> B
B --> C
B --> D["PostgreSQL Database"]
C --> D 图表说明
- 人工智能代理与MCP服务器交互的人工智能代理。
- MCP服务器暴露MCP接口的Spring Boot应用程序。
- PostgreSQL 数据库存储任务的共享数据库。
它连接到PostgreSQL数据库。
______________________________________________________________________
技术栈
- Spring Boot 3.2用于构建MCP服务器的后端框架。
- PostgreSQL（译为“波斯特高斯克吕格数据库”或直接保留原名，根据语境可灵活处理，但通常直接使用原名）用于存储任务的数据库。
- MCP用于AI代理与MCP服务器之间通信的模型上下文协议。
- Java 17及以上版本用于后端代码的编程语言。
- Spring Data JPA（注：JPA代表Java Persistence API，即Java持久化API，是用于Java平台的对象关系映射（ORM）规范）用于数据库交互的ORM（对象关系映射）库。
- Springdoc OpenAPI/Swagger用于生成API文档的文档框架。
______________________________________________________________________
🚀 如何运行
克隆仓库：
- 克隆仓库：https://github.com/your-org/taskmanager-mcp-server.git
- 进入 taskmanager-mcp-server 目录
- 更新 application.properties（或 application.yml）文件以配置您的本地数据库：
spring.datasource.url=jdbc:postgresql://localhost:5432/taskdb
spring.datasource.username=task_user
spring.datasource.password=task_pass
spring.jpa.hibernate.ddl-auto=update运行应用程序：
- \
mvn spring-boot:run\翻译成中文是：使用 Maven 运行 Spring Boot 应用 - 服务器启动时间：
👉 http://localhost:8080（本地主机：8080端口）
Swagger UI（交互式API文档）：
👉 http://localhost:8080/swagger-ui/index.html（中文翻译为：👉 本地主机8080端口Swagger UI界面）
______________________________________________________________________
🧠 AI代理（Claude）集成
- 克劳德（或另一个支持MCP的AI代理）通过配置文件进行连接。
- 示例 claude_desktop_config.json：
{
"mcpServers": {
"task-manager": {
"command": "node",
"args": [
"C:\\Users\\your-username\\IdeaProjects\\mcp\\mcp\\mcp-proxy.js"
]
}
}
}
其他机器的注意事项：
- 替换 _C:\\Users\\你的用户名\\IdeaProjects\\mcp\\mcp\\mcp-proxy.js_
使用您的 mcp-proxy.js 的绝对路径。
- 在Linux/Mac系统上，路径可能看起来像这样：
"/home/username/projects/mcp/mcp-proxy.js"- 确保路径正确且AI代理可以访问。
💬 给Claude的示例提示
Please inspect the task schema at /mcp/schema/tasks.
Then generate and insert 1000 diverse tasks with random statuses, titles, and due dates using the /mcp/tasks endpoint.
Finally, verify insertion using /mcp/tasks/summary.✅ 预期结果
- /mcp/schema/tasks → 返回任务的模式（或架构）
- /mcp/tasks → 插入约1000个任务
- /mcp/tasks/summary → 返回分析数据：
{
"totalTasks": 1000,
"statusDistribution": {
"TODO": 250,
"IN_PROGRESS": 200,
"DONE": 350,
"CANCELLED": 100,
"ON_HOLD": 100
},
"priorityDistribution": {
"LOW": 200,
"MEDIUM": 400,
"HIGH": 300,
"URGENT": 100
}
}______________________________________________________________________
📚 可交付成果
✅ 源代码（Spring Boot + MCP 服务器）
✅ PostgreSQL 配置
✅ README.md（此文件）
✅ Claude提示示例+结果
Swagger UI（交互式API文档）