返回 MCP 目录
public公开dns本地运行

mcp-task

一个基于MCP Go库和Redis的简单任务管理服务器演示项目,支持任务的创建、更新、删除、分配和状态标记等功能。

article

README

🚀 任务管理服务器演示项目

这是一个借助MCP Go库(由MegaGrindStone开发)搭建的简单任务管理服务器演示。项目运用Redis作为后端存储任务,主要用于展示MCP Go库的使用方法,同时提供一个简易的任务管理解决方案。不过,该项目并不适用于生产环境。

🚀 快速开始

此项目的运行需要满足一定的先决条件,具体如下:

  • Go 1.18 或更高版本
  • Redis 服务器(已包含在 docker-compose 文件中)

✨ 主要特性

  • 创建、更新、删除任务
  • 将任务分配给用户
  • 标记任务为完成
  • 按状态过滤任务
  • 按标题搜索任务

📦 安装指南

你可以选择使用 Docker 或在本地运行服务器,具体操作步骤如下:

Docker

docker-compose up

服务器启动后,你可以在 http://localhost:8090/sse 访问它。

本地

首先,根据你的需求配置 config.json 文件,你可以使用提供的 config.example.json 文件作为模板。同时,你必须本地运行 Redis 服务器。

go run main.go

同样,你可以在 http://localhost:8090/sse 访问服务器。

💻 使用示例

与服务器交互

使用 MCP 客户端

你可以使用 MegaGrindStone 的 MCP Web 界面 来与服务器交互。该 Web 界面是一个简单易用的任务管理界面,你可以通过它创建、更新、删除任务,并将它们分配给用户。

要声明 MCP 服务器,你可以使用以下配置文件:

port: 8080
logLevel: debug # 选择一个:debug, info, warn, error,默认为info
logMode: text # 选择一个:json, text,默认为text
systemPrompt: You are a helpful assistant.
titleGeneratorPrompt: 生成一个仅包含一句且不超过5个单词的标题。
# 选择以下LLM提供程序之一:ollama, anthropic
llm:

  # anthropic
  apiKey: XXX# 默认从环境变量ANTHROPIC_API_KEY获取
  model: claude-3-7-sonnet-20250219
  provider: anthropic
  # mistral
  # apiKey: XXXX
  # endpoint: https://api.mistral.ai/v1
  # model: mistral-large-latest
  maxTokens: 1000


mcpSSEServers:
  mcp-task-server:
    url: http://localhost:8090/sse
    maxPayloadSize: 1048576 # 1MB

提示示例

给我今天的工作任务
创建一个购买杂货的任务
创建一个明天下午7点去餐厅"Chez Michel"的任务

注意事项

⚠️ 重要提示

目前,Anthropic 客户端不支持 SSE 服务器。

🤝 贡献指南

如果你想为这个项目做出贡献,请随时打开问题或提交拉取请求。我们欢迎任何类型的贡献,无论是错误修复、新功能还是文档改进。

📄 许可证

此项目在 MIT 许可证下授权。有关详细信息,请参阅 LICENSE 文件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端