MCP 服务器

MCP-Server-Inbox

一个与 inBox 笔记 API 集成的 MCP 服务器，允许用户通过任何 MCP 客户端使用基于对话的交互来创建笔记。 (Alternatively, a slightly more formal translation:) 一个集成了 inBox 笔记 API 的 MCP 服务器，它允许用户通过任何 MCP 客户端，以对话交互的方式创建笔记。

Tools

write_note

Write note to inBox

README

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 格式的图片链接，例如：

今天天气很好，![](https://example.com/image.jpg)

注意：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 - 个人主页

许可证

MIT

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 格式的图片链接，例如：

今天天气很好，![](https://example.com/image.jpg)

注意：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 - 个人主页

许可证

MIT

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 格式的图片链接，例如：

今天天气很好，![](https://example.com/image.jpg)

注意：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 - 个人主页

许可证

MIT

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 格式的图片链接，例如：

今天天气很好，![](https://example.com/image.jpg)

注意：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 - 个人主页

许可证

MIT

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 格式的图片链接，例如：

今天天气很好，![](https://example.com/image.jpg)

注意：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 - 个人主页

许可证

MIT

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

MCP-Server-Inbox

Tools

README

MCP-Server-Inbox

功能介绍

前置条件

安装与使用

方法一：使用 npx 运行

方法二：本地构建

调试与开发

使用 Inspector

在 MCP 客户端中配置

Cursor AI

其他 MCP 客户端

使用示例

API 说明

write_note

inBox API 说明

接口信息

请求参数

使用示例

响应格式

图片支持

处理逻辑

限制说明

获取 inBox API 配置

贡献指南

更新日志

v0.1.0

作者

相关项目

许可证

MCP-Server-Inbox

功能介绍

前置条件

安装与使用

方法一：使用 npx 运行

方法二：本地构建

调试与开发

使用 Inspector

在 MCP 客户端中配置

Cursor AI

其他 MCP 客户端

使用示例

API 说明

write_note

inBox API 说明

接口信息

请求参数

使用示例

响应格式

图片支持

处理逻辑

限制说明

获取 inBox API 配置

贡献指南

更新日志

v0.1.0

作者

相关项目

许可证

MCP-Server-Inbox

功能介绍

前置条件

安装与使用

方法一：使用 npx 运行

方法二：本地构建

调试与开发

使用 Inspector

在 MCP 客户端中配置

Cursor AI

其他 MCP 客户端

使用示例

API 说明

write_note

inBox API 说明

接口信息

请求参数

使用示例

响应格式