AI导哈

TODO管理服务器

一个基于Model Context Protocol (MCP)的TODO管理服务器，支持HTTP和stdio传输协议，提供TODO的增删改查功能。

  • by marumaru1019
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 marumaru1019/PoC-TodoAdmin-MCP

使用说明

TODO管理MCP服务器

此项目包括：Model Context Protocol (MCP) 使用TODO管理服务器。 副驾驶工作室 (HTTP transport) 和 GitHub Copilot (stdio transport) 对较大场景进行渲染期间已观察到该故障。

特徴

  • ✅ Copilot Studio対応: HTTP (Streamable) transport支持
  • ✅ GitHub Copilot対応: stdio transport支持
  • 🗂️ JSON基于文件的持久化存储
  • 🛠️ 四个TODO操作工具

安装，安装

1.安装相关性

pip install -r requirements.txt

2.启动服务器

Copilot Studio用（HTTP服务器）

python3 server.py --http 3000

服务器是 http://localhost:3000/mcp 中所述修改相应参数的值。

GitHub Copilot对钢筋弯钩进行定位和定向

python3 server.py

或 .vscode/mcp.json 中设置：

{
  "servers": {
    "todo-server": {
      "command": "python3",
      "args": ["${workspaceFolder}/server.py"]
    }
  }
}

可用工具

1. 所有列表

所有注册的TODO获取列表。

入力：无

出力例:

[
  {
    "id": 1,
    "title": "買い物に行く",
    "description": "牛乳と卵を買う",
    "status": "pending"
  }
]

2.全部添加

新的TODO中所述修改相应参数的值。

入力:

  • title （必需）：TODO标题
  • description （可选）：TODO详细说明

出力：添加完成消息和ID

3.更新待办事项

现有TODO中所述修改相应参数的值。

入力:

  • id （必需）：更新TODO的，之ID
  • title （可选）：新标题
  • description （可选）：新的详细说明
  • status （可选）：“pending”或“completed”

出力：更新完成消息

4.删除_ todo

TODO中所述修改相应参数的值。

入力:

  • id （必需）：删除TODO的，之ID

出力：删除完成消息

Copilot Studio使用方法

1. HTTP启动服务器

python3 server.py --http 3000

2. VS Code在中设置端口转发

  1. VS Code打开端口选项卡
  2. 传输端口3000
  3. 发布URL复制（例如： https://xxx.devtunnels.ms/)

3. Copilot Studio注册工具

  1. 打开代理的“工具”选项卡
  2. “添加工具”→“新建工具”→“MCP工具”
  3. 输入：
    • 名前: TODO管理服务器
    • 说明: TODO创建、检索、更新和删除工具
    • 统一资源定位符: https://xxx.devtunnels.ms/mcp （端口转发的URL + /mcp)
  4. 单击测试连接
  5. 显示工具后，单击“添加”

4.代理使用

在与代理的对话中，发送以下消息：

TODOリストを表示して

「買い物に行く」というTODOを追加して

GitHub Copilot使用方法

.vscode/mcp.json 框中，选择“默认值”VS Code的，之GitHub Copilot 可以在代理模式下自动使用。

使用例:

@workspace 現在のTODOリストを確認して

@workspace 新しいTODOを追加: ドキュメント作成

保存数据

TODO数据是 todos.json 中所述修改相应参数的值。首次启动时自动创建。

故障排除

Copilot Studio中的“无法连接”错误

  • HTTP验证服务器是否已启动： curl http://localhost:3000/
  • VS Code确认端口转发是否有效
  • URL"； /mcp 查看项目中可用的所有族

GitHub Copilot缺少工具

  • .vscode/mcp.json 验证路径是否正确
  • VS Code重新启动
  • Python 3.11确认已安装以上内容

许可证

麻省理工学院

相关 MCP