AI导哈

任务管理应用

一个基于模型上下文协议（MCP）构建的简单任务管理应用，提供任务添加、删除、列出和完成等功能。

  • by Ismail-Lamrani
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Ismail-Lamrani/MCP-Task-Management

使用说明

📋 MCP任务管理器

一个简单的 任务管理 使用构建的应用程序 模型上下文协议（MCP） 使用 FastMCP.

本项目演示了如何构建MCP 服务器 它公开了工具和MCP 客户端 它连接到服务器并以交互方式调用这些工具。

📁 项目结构

MCP-Task-Management/
├── task_server.py   # MCP server — exposes task management tools
├── mcp_client.py    # MCP client — interactive CLI to manage tasks
└── README.md

⚙️ 先决条件

  • Python 3.10+
  • FastMCP --安装方式：
    pip install fastmcp
  • Node.js （可选） --仅当您想使用MCP检查器时才需要

🚀 入门指南

选项1：使用交互式客户端

客户端通过以下方式自动生成服务器 标准 --无需单独启动服务器。

python mcp_client.py

你会看到这样的菜单：

✅ Connected to Task Management Server!
📦 Available tools: ['add_task', 'remove_task', 'list_tasks', 'complete_task']

========================================
  📋 Task Manager - MCP Client
========================================
  1. Add a task
  2. Remove a task
  3. List all tasks
  4. Complete a task
  5. Exit
========================================

选项2：使用MCP检查器（可视化UI）

这 MCP检查员 提供了一个基于web的UI来测试您的服务器。

npx @modelcontextprotocol/inspector python task_server.py

然后打开终端中显示的URL（通常 http://localhost:6274).

⚠️ 重要提示： 检查员使用 标准 运输。确保 task_server.py 设置为 mcp.run() （不是HTTP传输）。

选项3：使用HTTP传输运行服务器

如果你想通过HTTP连接（例如，从web应用程序或使用curl）：

# In task_server.py, change the last line to:
mcp.run(transport="http", host="localhost", port=8000)

python task_server.py
# Server will be available at http://localhost:8000/mcp

🛠️ 可用工具

工具 参数 说明
add_task task_name: str 添加新任务
remove_task task_id: int 按任务ID删除任务
list_tasks 无 列出所有任务及其状态
complete_task task_id: int 将任务标记为已完成

🔌 运输方式

模式 用例 如何运行
标准 （默认） 客户端/检查器将服务器作为子进程生成 mcp.run()
超文本传输协议 浏览器、curl或远程客户端 mcp.run(transport="http", host="localhost", port=8000)

相关 MCP