mcpField
T
Todo App with MCP Server

Todo App with MCP Server

本地服务
github.com/sam55silver生产力080 周前更新

关于 Todo App with MCP Server

这是一个演示用 Todo 应用,包含 FastAPI 后端和 MCP 服务,可让 AI 助手执行 Todo 操作。项目还提供 React/TypeScript 前端及 Claude Desktop 配置说明。

主要功能

  1. 01React/TypeScript Todo 前端
  2. 02FastAPI Todo 后端
  3. 03通过工具操作 Todo
  4. 04Claude Desktop 配置指南

适用场景

  1. 01让 Claude Desktop 操作 Todo
  2. 02体验由 MCP 驱动的 Todo 应用

MCP 相关

MCP 服务通过工具向 MCP 客户端开放 Todo 应用操作,包括 Claude Desktop。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

使用 MCP 服务的待办事项应用

项目概览

本项目演示如何构建一个与简单待办事项应用交互的模型上下文协议(MCP)服务。项目由三个主要组件组成:

  1. 客户端:React/TypeScript 前端应用
  2. 服务端:用于管理待办事项的 FastAPI 后端
  3. MCP 服务:专门用于通过工具与待办事项应用交互的服务

什么是 MCP(模型上下文协议)?

模型上下文协议(MCP)是 Anthropic 开发的一项开放标准,可让 AI 系统动态连接外部工具、文件和 API。它提供了一种标准化方式,使 AI 模型能够通过定义的工具访问实时数据并执行操作。

MCP 采用客户端—服务端架构:

  • MCP 服务:提供对数据和功能的结构化访问(例如我们的待办事项 API)
  • MCP 客户端:请求 MCP 服务提供上下文或执行操作的 AI 应用

可以把 MCP 想象成“用于 AI 连接的 USB-C”——一种通用接口,让 AI 系统能够无缝集成外部数据源和工具,无需为每个新系统单独定制集成。

开始使用

先决条件
  • Docker 和 Docker Compose
  • NodeJS
  • Python
  • UV(Python 包管理器)
  • Claude Desktop(用于搭配 Anthropic 的 Claude AI)
启动应用
  1. 克隆此仓库
  2. 运行 Docker Compose 以启动所有服务:
docker-compose up

这将启动以下服务:

搭配 Claude Desktop 使用

要将 MCP 服务与 Claude Desktop 搭配使用:

  1. 找到 Claude Desktop 配置文件:
    • macOS:~/Library/Application Support/Claude Desktop/claude_desktop_config.json
    • Windows:%APPDATA%\Claude Desktop\claude_desktop_config.json
    • Linux:~/.config/Claude Desktop/claude_desktop_config.json
  2. 在配置中添加或更新 mcpServers 部分,以添加 todo-mcp 服务:
{
  "mcpServers": {
    "todo-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/repo/todo-mcp",
        "run",
        "main.py"
      ]
    }
  }
}
  1. 将 /path/to/repo/todo-mcp 替换为 todo-mcp 目录的实际路径
  2. 保存文件并重启 Claude Desktop
  3. 使用 Claude 时,即可通过 Claude 界面访问 todo-mcp 服务及其工具

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。