使用说明
Todo 应用的 MCP 服务器
观看视频📺
概述
这个项目展示了 用于待办事项应用的本地MCP服务器 使用 FastMCP，以及 紫外线 用于项目管理和 检查员 验证本地stdio服务器是否正常工作。目标是提供一个基于命令的交互式工具，以 添加、列出和删除待办事项 在将数据持久化存储到JSON文件中时。
---目录
引言
建立本地MCP服务器使您能够通过Python脚本高效管理任务。此项目利用了 FastMCP 定义用于对待办事项和用例执行CRUD（创建、读取、更新、删除）操作的工具 紫外线 和 检查员 用于监控项目工作流程和服务器健康状况。
目标
- 构建一个本地MCP服务器用于任务管理。
- 通过简单的命令行界面添加、列出和删除待办事项。
- 将所有数据持久化存储在一个JSON文件中。
- 使用（工具/方法）监控服务器状态 检查员。
- 使用 紫外线 用于项目管理任务。
项目文件
输入
todos.json- 永久存储所有待办事项。main.py- 主MCP服务器脚本。
你可以通过删除来重新开始 todos.json服务器将自动重新创建它。
所使用的技术
- python核心编程语言。
- FastMCP定义工具并运行MCP服务器的框架。
- 检查员检查本地stdio服务器的功能。
- 紫外线Python工作流的项目管理工具。
- **JSON（JavaScript Object Notation）**持久存储待办事项。
安装
先决条件
确保您的系统上已安装 Python（版本 >= 3.10）。
步骤
-
克隆仓库：
git clone https://github.com/DataScientist00/MCP-Server-TODO-app.git cd todo-mcp-server -
创建并激活虚拟环境：
python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate -
安装依赖项：
pip install -r requirements.txt
用法
使用以下命令运行MCP服务器：
uv run fastmcp run main.py
服务器将：
- 加载或创建
todos.json。 - 提供CLI工具以 添加， 列表，和 删除所有。
- 允许您通过（某种方式）监控本地stdio服务器 检查员。
- 使用 紫外线 组织和管理项目工作流程。
特点/特性
- 本地MCP服务器运行一个基于命令行的待办事项服务器。
- 持久存储所有任务均已保存在
todos.json。 - 添加/列出/删除待办事项通过简单的CLI工具进行CRUD操作。
- 服务器监控使用Inspector验证服务器状态。
- 项目管理组织工作流程与 紫外线。
- 轻量级且快速简单的Python脚本，无繁重依赖。
结果
-
高效的任务管理实时添加、查看和删除任务。
-
数据持久化所有数据在服务器重启后仍然保留。
-
项目监控确保本地MCP服务器正在正常运行。
-
应用程序:
- 个人任务管理
- 学习MCP服务器设置
- 基于Python的工作流实验
做出贡献
我们欢迎对本项目进行贡献以助其完善！要参与贡献：
- 为该仓库创建分支。
- 创建一个新分支（
git checkout -b feature/your-feature-name）。 - 进行你的更改并提交（
git commit -m 'Add new feature'）。 - 推送至分支（
git push origin feature/your-feature-name）。 - 创建一个拉取请求。
致谢
- 多亏了 FastMCP 以便轻松通过工具创建服务器。
- 检查员 用于监控本地stdio服务器。
- Python开源社区提供支持与灵感。
联系
如有问题或需要支持，请联系我们：
