任务管理MCP服务器
一个作为模型上下文协议（MCP）服务器构建的综合任务管理系统，为具有多用户分配功能的任务管理提供完整的CRUD操作。
特性
- ✅ 完成CRUD操作 -创建、读取、更新、删除任务
- 👥 多用户分配 -将任务分配给不同的团队成员
- 📊 状态跟踪 -使用可定制的状态监控任务进度
- ⏰ 自动时间戳 -创建/更新时间的UTC时区跟踪
- 🔍 任务筛选 -按ID检索所有任务或特定任务
- 📝 详细说明 -丰富的任务描述和元数据
- 🚀 MCP集成 -与AI助手无缝集成
安装
先决条件
- Java 11或更高版本（JDK）
- Maven 3.6+或Gradle 6+
- Git
设置
- 克隆存储库
git clone https://github.com/yourusername/task-management-mcp-server.git
cd task-management-mcp-server- 构建项目
使用Maven：
mvn clean install使用Gradle：
./gradlew build- 运行服务器
使用Maven：
mvn spring-boot:run使用Gradle：
./gradlew bootRun使用JAR：
java -jar target/task-management-mcp-server-1.0.0.jarMCP配置
要将此服务器与Claude Desktop或其他MCP客户端一起使用，请将以下配置添加到MCP设置文件中：
Claude桌面配置
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"task-management": {
"command": "java",
"args": ["-jar", "path/to/your/task-management-mcp-server/target/task-management-mcp-server-1.0.0.jar"],
"env": {}
}
}
}替代MCP工具
对于其他MCP兼容客户端：
# Using MCP CLI
mcp connect task-management-mcp-server
# Or via Java MCP SDK
import com.anthropic.mcp.MCPClient;
MCPClient client = new MCPClient("task-management-mcp-server");api参考
可用工具
1.创建任务
createTask(request)- 描述：创建具有指定详细信息的新任务
- 参数:
- title （字符串，必填）：任务标题 - description （字符串，必填）：任务描述 - status （字符串，必填）：任务状态（例如，“待定”、“已完成”） - assignee （string，必填）：分配给任务的人员
2.获取所有任务
getAllTasks()- 描述：检索系统中的所有任务
- 退货：包含完整详细信息的所有任务数组
3.按ID获取任务
getTaskById(id)- 参数:
- id （整数，必填）：唯一任务标识符
4.更新任务
updateTask(id, request)- 参数:
- id （整数，必填）：要更新的任务ID - request （对象，必填）：更新的任务详细信息（格式与创建相同）
5.删除任务
deleteTask(id)- 参数:
- id （整数，必填）：要删除的任务ID
任务对象结构
每个任务都包含以下属性：
{
"id": 1,
"title": "Task Title",
"description": "Detailed task description",
"status": "pending",
"assignee": "John Doe",
"createdAt": [2025, 8, 30, 20, 30, 51, 366682000],
"updatedAt": [2025, 8, 30, 20, 33, 3, 279679000]
}时间戳格式
时间戳存储为数组： [year, month, day, hour, minute, second, nanoseconds] UTC时区。
使用示例
Claude AI助手
# Create a new task
"Create a task for John to review the quarterly budget"
# View all tasks
"Show me all current tasks"
# Update task status
"Mark task ID 5 as completed"
# Assign task to different person
"Reassign the budget review task to Sarah"
# Delete completed tasks
"Delete task ID 3"API直接使用
// Example: Creating a task
TaskRequest request = new TaskRequest();
request.setTitle("Review monthly reports");
request.setDescription("Analyze sales and performance metrics");
request.setStatus("pending");
request.setAssignee("Alice Smith");
Task newTask = taskService.createTask(request);
// Example: Getting all tasks
List allTasks = taskService.getAllTasks();
System.out.println("Total tasks: " + allTasks.size());常见状态值
虽然您可以使用任何状态值，但以下是一些常见的状态值：
pending-任务尚未启动in-progress-目前正在进行中completed-任务已完成on-hold-暂时暂停cancelled-任务已取消
发展
项目结构
task-management-mcp-server/
├── src/
│ ├── main/
│ │ ├── java/
│ │ │ └── com/yourcompany/taskmanagement/
│ │ │ ├── TaskManagementApplication.java
│ │ │ ├── controller/
│ │ │ │ └── TaskController.java
│ │ │ ├── service/
│ │ │ │ └── TaskService.java
│ │ │ ├── model/
│ │ │ │ └── Task.java
│ │ │ └── repository/
│ │ │ └── TaskRepository.java
│ │ └── resources/
│ │ ├── application.properties
│ │ └── application.yml
│ └── test/
│ └── java/
├── pom.xml # Maven dependencies
├── build.gradle # Gradle dependencies (alternative)
└── README.md # This file运行测试
使用Maven：
mvn test使用Gradle：
./gradlew test贡献
- 分叉存储库
- 创建要素分支(
git checkout -b feature/new-feature) - 进行更改
- 提交您的更改(
git commit -am 'Add new feature') - 推到分支(
git push origin feature/new-feature) - 创建拉取请求
故障排除
常见问题
服务器无法启动：
- 检查Java版本（需要>=11）
- 验证Maven/Gradle构建是否成功完成
- 检查端口8080是否可用（或配置的端口）
- 查看application.properties配置
构建问题：
- 跑
mvn clean install或./gradlew clean build - 检查Maven/Gradle版本兼容性
- 验证依赖项下载的互联网连接
未持续的任务：
- 检查application.properties中的数据库配置
- 验证数据库连接和权限
- 查看JPA/Hibernate实体映射
MCP连接问题：
- 验证MCP客户端配置
- 检查服务器日志中的连接错误
- 确保配置中的路径正确
许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
支持
- 📧 电子邮件：support@yourproject.com
- 🐛 问题：
- 📖 文档： 维基
更新日志
v1.0.0（初始版本）
- 使用Spring Boot完成任务的CRUD操作
- 多用户分配支持
- 使用JPA跟踪UTC时间戳
- MCP服务器集成
- 状态管理系统
- RESTful API端点
- H2/PPostgreSQL数据库支持
______________________________________________________________________
由以下材料制成❤️ 对于MCP社区