MCP-Server-Inbox

基本能力

产品定位

MCP-Server-Inbox 是一个笔记管理服务，通过对接 inBox 笔记 API，实现在 MCP 客户端中快速创建和管理笔记的功能。

核心功能

• 接入 inBox 笔记 API
• 提供 MCP 服务发现接口
• 支持通过 MCP 客户端创建笔记
• 支持设置笔记标题（可选）
• 支持 Inspector 调试工具

适用场景

• 快速记录学习笔记
• 整理项目文档
• 日常任务管理

工具列表

• Inspector 调试工具：用于调试和监控服务运行状态，可通过浏览器访问 http://localhost:5173 查看。

常见问题解答

• API 请求频率限制：每天最多 50 条笔记。
• 笔记内容限制：最多支持 3000 字符。
• inBox API 要求：需要 inBox PRO 用户才能使用 API 功能。

使用教程

使用依赖

• 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

方法二：本地构建

1. 克隆代码仓库

git clone https://github.com/maoruibin/mcp-server-inbox.git
cd mcp-server-inbox

1. 安装依赖

npm install

1. 构建项目

npm run build

1. 运行服务

# 运行服务
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

npm run inspector

运行后可以在浏览器中访问 http://localhost:5173 查看服务运行状态和调试信息。

在 MCP 客户端中配置（以 Cursor AI 为例）

1. 打开 Cursor 的 MCP 服务配置文件（通常位于 ~/.cursor/mcp.json）
2. 添加 mcp-server-inbox 的配置：

{
  "mcpServers": {
    "mcp-server-inbox": {
      "command": "npx",
      "args": [
        "mcp-server-inbox"
      ],
      "env": {
        "INBOX_USER_TOKEN": "your api path"
      }
    }
  }
}

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。