MCP Server Inbox

🚀 MCP-Server-Inbox 中文版

MCP 服務與 inBox 筆記 API 對接，可讓任意 MCP 客戶端以對話形式創建筆記，極大提升了筆記創建的便捷性。

✨ 主要特性

• 接入 inBox 筆記 API，實現與筆記服務的無縫對接。
• 提供 MCP 服務發現接口，方便服務的查找與使用。
• 支持通過 MCP 客戶端創建筆記，操作簡單便捷。
• 支持設置筆記標題（可選），滿足多樣化的筆記記錄需求。
• 支持 Inspector 調試工具，便於即時監控和調試服務運行狀態。

📦 安裝指南

前置條件

• Node.js 18+
• inBox 筆記 API (PRO 功能)
• 支持 MCP 協議的客戶端

安裝方法

使用以下命令安裝項目：

npm install mcp-server-inbox

配置方式

項目支持兩種配置方式：

1. Token 配置：在環境變量中設置 INBOX_TOKEN。
2. 完整 URL 配置：在環境變量中設置 INBOX_API_URL。

💻 使用示例

啟動服務

通過以下命令啟動 MCP 服務器：

node index.js

基礎用法

用戶可以在 MCP 客戶端中輸入如下內容創建筆記：

幫我記筆記，標題是「我的第一個筆記」：這是筆記內容...

服務將自動提取標題和內容，並調用 inBox API 創建筆記。

📚 詳細文檔

API 說明

請求格式

POST /api/note HTTP/1.1
Content-Type: application/json

{
    "title": "string",
    "content": "string"
}

響應格式

{
    "code": integer,
    "message": string
}

示例響應：

{
    "code": 0,
    "message": "筆記創建成功"
}

處理邏輯

1. 解析用戶輸入，識別標題和內容。
2. 調用 inBox API 創建筆記。
3. 返回處理結果。

調試工具

項目內置 Inspector 調試工具，支持即時監控和調試服務運行狀態。具體使用方法請參考文檔。

獲取 API 配置

1. 打開 inBox 應用。
2. 進入【設置】 -> 【賬戶】 -> 【API】。
3. 獲取專屬的 API 配置信息。

🔧 技術細節

注意事項

• 每天最多支持 50 條筆記創建。
• 筆記內容不超過 3000 字符。
• 需要 inBox PRO 用戶身份才能使用 API 功能。

貢獻指南

歡迎提交 Issue 和 Pull Request。在提交 PR 前，請確保：

• 代碼通過 TypeScript 編譯。
• 所有功能經過測試。
• 文檔更新及時。

更新日誌

v0.1.0

• 初始版本發佈
• 支持基本的筆記創建功能
• 支持 Token 和完整 URL 兩種配置方式
• 添加 Inspector 調試工具支持

作者信息

gudong - 個人主頁

相關項目

• inBox - 簡單好用的筆記服務
• MCP 協議 - Model Context Protocol 規範

📄 許可證

MIT