AI导哈

任务管理MCP服务器

Task Manager MCP Server是一个基于Spring Boot的应用程序，通过Model Context Protocol (MCP)接口使AI代理（如Claude、GPT-4等）能够与共享的PostgreSQL任务管理数据库进行交互。

  • by AnushaSidhanti89
  • Java
  • 本地部署
  • 更新于
在 GitHub 查看 AnushaSidhanti89/taskmanager-mcp-server

使用说明

📝 任务管理器 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文档）

相关 MCP