Back to MCP directory
publicPublicdnsLocal runtime

todo-mcp-server

一个基于SQLite的简单待办事项管理MCP服务器

article

README

🚀 待办事项 MCP 服务器

这是一个简单的MCP(模型上下文协议)服务器,专门用于管理待办事项。它借助SQLite数据库进行数据存储,能有效且稳定地记录待办事项信息。

✨ 主要特性

  • 可添加新的待办事项,方便用户随时记录新任务。
  • 能够列出所有待办事项,让用户对任务一目了然。
  • 支持根据ID删除待办事项,便于清理已完成或不需要的任务。

📦 安装指南

  1. 安装依赖:
npm install
  1. 配置数据库位置(可选): 打开 src/database.ts 文件,并修改 DB_LOCATION 变量为您偏好的位置:
// 示例:
// - Windows: "C:/todos"
// - macOS: join(homedir(), "todos")
// - Linux: "/home/username/todos" 或 join(homedir(), "todos")
// - 当前目录:join(process.cwd(), "data")
const DB_LOCATION = "C:/todos";
  1. 构建项目:
npm run build

📚 详细文档

数据库

该应用程序使用SQLite进行数据存储。默认情况下,数据库文件位于 C:/todos/todos.db。您可以通过修改 src/database.ts 文件中的 DB_LOCATION 变量来更改此位置。如果指定的目录和数据库文件不存在,它们会自动创建。

可用工具

add - todo

添加一个新的待办事项到列表中。 参数:

  • text (字符串):待办事项的文字内容 示例:
add-todo(text: "购买杂货")

get - todos

列出所有待办事项。 示例:

get-todos()

remove - todo

根据ID删除一个待办事项。 参数:

  • id (数字):要删除的待办事项的ID 示例:
remove-todo(id: 1)

🔧 技术细节

该项目使用以下技术构建:

  • TypeScript:提供类型检查,增强代码的健壮性和可维护性。
  • better - sqlite3 进行数据库操作:高效地与SQLite数据库进行交互。
  • MCP SDK 实现服务器:借助MCP SDK搭建服务器,实现待办事项管理的各项功能。
help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client