返回 MCP 目录
public公开dns本地运行

todo_mcp_server

一个基于TypeScript的简易待办事项MCP服务器,支持添加、删除、标记完成和获取所有待办项功能。

article

README

🚀 待办事项 MCP 服务器

这是一个使用 TypeScript SDK 构建的简单待办事项模型上下文协议(MCP)服务器,能够帮助用户管理待办事项,提供添加、删除、标记完成以及获取所有待办事项等功能。

✨ 主要特性

  • 添加和删除待办事项
  • 标记待办事项为完成
  • 获取所有待办事项

📦 安装指南

  1. 克隆仓库
  2. 安装依赖:
npm install

🚀 快速开始

开发环境

运行开发服务器:

npm run dev

生产环境

构建生产版本:

npm run build

💻 使用示例

使用 mcp-inspector 进行测试

  1. 安装 mcp-inspector(如果尚未安装):
npm install -g @modelcontext/mcp-inspector
  1. 构建你的 MCP 服务器:
npm run build
  1. 在新的终端中,检查服务器:
mcp-inspector node /path/to/repo/build/index.js

本地 MCP 服务器安装

要在其他本地项目中使用此 MCP 服务器:

  1. 构建服务器:
npm run build
  1. 链接包:
npm link
  1. 配置项目的 mcp.config.json:
{
  "mcpServers": {
    // ...
    "todo": {
      "command": "node",
      "args": [
        "/path/to/repo/build/index.js"
      ]
    }
  }
}

📚 详细文档

项目结构

  • src/ - 包含所有源文件
    • index.ts - 应用程序主入口点
  • build/ - 包含构建输出(在构建时创建)
  • package.json - 项目配置和依赖项
  • tsconfig.json - TypeScript 配置

可用脚本

  • dev - 启动开发服务器
  • build - 构建生产版本
  • watch - 监控更改并重建
  • clean - 删除构建 artifact
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端