MCP-Server-Inbox
MCP 服务对接 inBox 笔记 API，实现在任意 MCP 客户端以对话形式创建笔记的功能。
功能介绍
- 接入 inBox 笔记 API
- 提供 MCP 服务发现接口
- 支持通过 MCP 客户端创建笔记
- 支持设置笔记标题（可选）
- 支持 Inspector 调试工具
前置条件
- Node.js 18+
- inBox 笔记 API (PRO 功能)
- 支持 MCP 协议的客户端（如 Cursor AI）
安装与使用
方法一：使用 npx 运行
# 运行服务
npx mcp-server-inbox --inbox_user_token=https://inbox.gudong.site/api/inbox/your_token_here
# 使用环境变量
INBOX_USER_TOKEN=https://inbox.gudong.site/api/inbox/your_token_here npx mcp-server-inbox
方法二：本地构建
- 克隆代码仓库
git clone https://github.com/maoruibin/mcp-server-inbox.git
cd mcp-server-inbox
- 安装依赖
npm install
- 构建项目
npm run build
- 运行服务
# 运行服务
node build/index.js --inbox_user_token=https://inbox.gudong.site/api/inbox/your_token_here
# 使用环境变量
INBOX_USER_TOKEN=https://inbox.gudong.site/api/inbox/your_token_here node build/index.js
调试与开发
使用 Inspector
项目内置了 MCP Inspector 工具，可以帮助调试和监控服务运行状态：
npm run inspector
运行后可以在浏览器中访问 http://localhost:5173 查看服务运行状态和调试信息。
在 MCP 客户端中配置
Cursor AI
- 打开 Cursor 的 MCP 服务配置文件（通常位于
~/.cursor/mcp.json） - 添加 mcp-server-inbox 的配置：
{
"mcpServers": {
"mcp-server-inbox": {
"command": "npx",
"args": [
"mcp-server-inbox"
],
"env": {
"INBOX_USER_TOKEN": "your api path"
}
}
}
}
其他 MCP 客户端
请参考对应 MCP 客户端的配置文档，添加类似的配置信息。
使用示例
在支持 MCP 的客户端中，您可以使用自然语言与 AI 对话，来创建笔记：
- "记录一下：今天学习了 MCP 开发"
- "帮我记笔记，标题是「TypeScript学习」：TypeScript 的高级类型包括 Partial、Required、Pick 等"
- "写到 inBox：明天需要完成项目文档编写"
API 说明
write_note
- 描述：将笔记内容写入到 inBox
- 参数：
- title：笔记标题（可选）
- content：笔记内容（Markdown 格式），最多 3000 字符
- 返回：
- 成功：返回包含成功信息的对象
- 失败：抛出相应的错误信息
inBox API 说明
本项目依赖 inBox 的 API 服务，具体说明如下：
接口信息
- 接口地址：
https://app.gudong.site/api/inbox/${userToken} - 请求方式：
POST - Content-Type：
application/json - 请求频率：每天最多 50 条
请求参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| title | 字符串 | 否 | 笔记标题 |
| content | 字符串 | 是 | 笔记内容，最多 3000 字符 |
使用示例
- 创建普通笔记：
npx mcp-server-inbox --inbox_user_token=https://inbox.gudong.site/api/inbox/your_token_here
- 创建带标题的笔记：
# 在对话中指定标题
"帮我记笔记，标题是「TypeScript学习」：TypeScript 的高级类型包括 Partial、Required、Pick 等"
响应格式
{
"code": 0,
"msg": "已提交，请打开inBox查看笔记"
}
说明：code 为 0 表示请求成功，非零状态均为失败
图片支持
inBox API 支持解析 Markdown 格式的图片标签。您可以在笔记内容中添加 markdown 格式的图片链接，例如：
今天天气很好，
注意：API 不支持直接上传图片，需要先将图片上传到图床后使用图片链接
更多 API 详细信息请参考：inBox API 文档
处理逻辑
当用户通过 MCP 客户端发送创建笔记的请求时，服务会根据以下逻辑处理：
- 解析用户输入，识别标题（如有）和内容
- 调用 inBox API，直接传递
title和content两个参数 - 返回处理结果和笔记内容摘要
用户可以在对话中明确指定标题，例如："帮我记笔记，标题是「TypeScript学习」：这是内容..."，服务会自动提取标题部分。
限制说明
- inBox API 请求频率限制为每天最多 50 条
- 笔记内容最多支持 3000 字符
- 需要 inBox PRO 用户才能使用 API 功能
获取 inBox API 配置
- 打开 inBox 应用
- 进入【设置】->【账户】->【Api】
- 获取您的专属 API 配置信息
贡献指南
欢迎提交 Issue 和 Pull Request 来帮助改进这个项目。在提交 PR 之前，请确保：
- 代码通过 TypeScript 编译
- 所有功能都经过测试
- 更新相关文档
更新日志
v0.1.0
- 初始版本发布
- 支持基本的笔记创建功能
- 支持 Token 和完整 URL 两种配置方式
- 添加 Inspector 调试工具支持
作者
gudong - 个人主页
相关项目
- inBox - 简单好用的笔记服务
- MCP Protocol - Model Context Protocol 规范
许可证
MIT