Todo列表服务器

一个演示MCP服务器实现的Todo列表应用,支持TypeScript和Python两种语言版本。

  • by japantechcareerlab
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 japantechcareerlab/hands-on-mcp

使用说明

动手MCP(模型上下文协议)

该项目演示了MCP服务器在TypeScript和Python中的实现,并提供了一个简单的Todo List应用程序。

项目结构

hands-on-mcp/
├── ts-server/              # TypeScript MCP server
│   ├── .mise.toml          # Node.js 20
│   ├── src/
│   │   ├── index.ts
│   │   ├── types.ts
│   │   └── tools/
│   ├── package.json
│   └── Makefile
└── python-server/          # Python MCP server
    ├── .mise.toml          # Python 3.11, Node.js 20
    ├── src/
    │   ├── index.py
    │   ├── types.py
    │   └── tools/
    ├── requirements.txt
    ├── pyproject.toml
    └── Makefile

先决条件

  • 布置 -运行时版本管理器

设置

安装mise(如果尚未安装):

# macOS/Linux
curl https://mise.run | sh

# Or with Homebrew
brew install mise

每台服务器都有自己的 .mise.toml 配置,并在运行命令时自动安装所需的工具。

快速开始

TypeScript服务器

cd ts-server

# Install dependencies
make install

# Run in development mode
make dev

# Run with inspector
make inspector

Python服务器

cd python-server

# Install dependencies
make install

# Run in development mode
make dev

# Run with inspector
make inspector

特性

两台服务器都实现了相同的待办事项列表功能:

  • 全部添加:添加新的待办事项
  • list_所有:使用可选筛选列出所有待办事项
  • complete_todo:将待办事项标记为完成

文档

MCP资源

许可证

麻省理工学院