待办事项和笔记管理插件

一个功能完整的MCP兼容REST API,用于管理待办事项和笔记,支持ChatGPT操作。

  • by applink1
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 applink1/todo-notes-mcp

使用说明

待办事项和笔记管理器——MCP插件

部署到铁路→ 在ChatGPT操作市场上发布


这是什么

功能齐全 MCP-兼容REST API 用于管理待办事项和笔记。 它公开了一个标准的OpenAPI规范,ChatGPT读取该规范以了解它可以代表您采取什么行动。

ChatGPT将能够做什么:

  • “在我的待办事项中加入买牛奶”
  • “将我的牙医预约标记为已完成”
  • “显示我的所有待处理任务”
  • “用这些要点保存一个标题为“会议摘要”的笔记…”
  • “删除所有已完成的待办事项”

项目结构

todo-mcp/
├── src/
│   └── server.js          ← Express API + OpenAPI spec + plugin manifest
├── public/
│   └── index.html         ← Test UI (also served by the API)
├── package.json
├── railway.toml            ← Railway deployment config
└── .gitignore

第一步——推送到GitHub(免费)

  1. 首选https://github.com/new并创建一个 新公共回购 (例如。 todo-notes-mcp)
  2. 在您的终端中,从项目文件夹中:
git init
git add .
git commit -m "Initial commit: Todo & Notes MCP plugin"
git branch -M main
git remote add origin https://github.com/YOUR_USERNAME/todo-notes-mcp.git
git push -u origin main

第二步——部署到铁路(免费)

铁路的免费爱好层给你 $5/月免费积分 --足够运行这个24/7。

  1. 首选 https://railway.app 并注册(使用GitHub登录以提高速度)
  2. 点击 “新项目” → “从GitHub仓库部署”
  3. 选择您的 todo-notes-mcp 仓库
  4. Railway通过nixpacks自动检测Node.js——无需配置
  5. 点击 “部署” --大约需要60秒
  6. 首选 设置→ 网络→ 生成域
  7. 复制您的公共URL(例如。 https://todo-notes-mcp-production.up.railway.app)

✅ 测试:访问 https://YOUR_RAILWAY_URL/health --你应该看看 {"status":"ok"} ✅ 查看UI:访问 https://YOUR_RAILWAY_URL --测试界面加载 ✅ 检查清单:访问 https://YOUR_RAILWAY_URL/.well-known/ai-plugin.json


步骤3——注册为ChatGPT操作

选项A:ChatGPT自定义GPT(最简单)

  1. 首选https://chatgpt.com → 点击您的头像→ “我的GPTs” → “创建GPT”
  2. 点击 “配置” 标签
  3. 滚动到 “行动” → Click “创建新操作”
  4. 在 “架构” 字段,粘贴您的OpenAPI URL:
    https://YOUR_RAILWAY_URL/openapi.yaml
    
    ChatGPT将自动导入您的所有端点。
  5. 集 认证 到 无
  6. 点击 “保存” → 命名您的GPT(例如“我的待办事项管理器”)
  7. 在聊天中测试它: “添加高优先级待办事项:完成报告”

选项B:ChatGPT插件市场(开发者预览版)

注意:插件市场目前仅接受邀请。上面的自定义GPT路径 是公开发布的最快方式。

  1. 首选https://platform.openai.com/docs/plugins
  2. 申请插件开发者访问权限
  3. 提交您的插件清单URL: https://YOUR_RAILWAY_URL/.well-known/ai-plugin.json

步骤4——测试MCP端点

使用curl:

# Create a todo
curl -X POST https://YOUR_RAILWAY_URL/todos \
  -H "Content-Type: application/json" \
  -d '{"title": "Buy groceries", "priority": "high"}'

# Get all todos
curl https://YOUR_RAILWAY_URL/todos

# Mark complete (replace ID with real id from above response)
curl -X PATCH https://YOUR_RAILWAY_URL/todos/SOME_ID \
  -H "Content-Type: application/json" \
  -d '{"completed": true}'

# Create a note
curl -X POST https://YOUR_RAILWAY_URL/notes \
  -H "Content-Type: application/json" \
  -d '{"title": "Meeting notes", "content": "Discussed Q1 targets", "tags": ["work","q1"]}'

升级:添加持久存储

现在,当铁路重新启动服务时,数据会重置。 要永久免费保存数据:

选项:铁路+PostgreSQL(免费)

  1. 在您的铁路项目中→ “新服务” → “数据库” → “PostgreSQL”
  2. 铁路汽车组 DATABASE_URL env 是
  3. 安装pg: npm install pg
  4. 更换中的内存阵列 server.js 使用SQL查询

选项:PlanetScale(免费MySQL,5GB)

  1. 注册地址:https://planetscale.com(免费套餐)
  2. 创建数据库→ 获取连接字符串
  3. 集 DATABASE_URL 铁路环境变量

API 参考

方法 端点 描述
GET /所有 列出所有 (?status=pending|completed|all)
POST /todos 创建todo {title, priority, dueDate}
PATCH /todos/:id 更新todo {title, completed, priority}
删除 /todos/:ID 删除todo
GET /notes 列出所有笔记
POST /notes 创建注释 {title, content, tags[]}
PATCH /notes/:id 更新注释
DELETE /notes/:id 删除注释
GET /.knowledge/ai-plugin.json 插件清单
GET /openapi.yaml openapi 3.0规范
GET /health 健康检查

总成本:0美元

服务 成本
GitHub 免费
铁路爱好 免费(每月5美元)
ChatGPT自定义GPT 免费
总计 $0
#� �t�o�d�o�-�n�o�t�e�s�-�m�c�p�
�
�