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

設定方法

プロジェクトは2種類の設定方法をサポートしています。

1. トークン設定：環境変数にINBOX_TOKENを設定します。
2. 完全URL設定：環境変数にINBOX_API_URLを設定します。

💻 使用例

サービスの起動

以下のコマンドでMCPサーバーを起動します。

node index.js

基本的な使用法

ユーザーはMCPクライアントに以下の内容を入力してノートを作成できます。

帮我记笔记，标题是「我的第一个笔记」：这是笔记内容...

サービスは自動的にタイトルと内容を抽出し、inBox APIを呼び出してノートを作成します。

📚 ドキュメント

デバッグツール

プロジェクトにはInspectorデバッグツールが組み込まれており、サービスの実行状態をリアルタイムで監視およびデバッグできます。具体的な使用方法はドキュメントを参照してください。

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. 処理結果を返します。

注意事項

⚠️ 重要提示

• 1日に作成できるノートは最大50件です。
• ノート内容は3000文字以内です。
• API機能を使用するにはinBox PROユーザーである必要があります。

API設定の取得方法

1. inBoxアプリを開きます。
2. 【設定】 -> 【アカウント】 -> 【API】にアクセスします。
3. 専用のAPI設定情報を取得します。

貢献ガイド

IssueとPull Requestの投稿を歓迎します。PRを投稿する前に、以下のことを確認してください。

• コードがTypeScriptでコンパイルされること。
• すべての機能がテストされていること。
• ドキュメントが最新の状態であること。

更新履歴

v0.1.0

• 初期バージョンのリリース
• 基本的なノート作成機能のサポート
• トークンと完全URLの2種類の設定方法のサポート
• Inspectorデバッグツールのサポート追加

作者情報

gudong - 個人ページ

関連プロジェクト

• inBox - シンプルで使いやすいノートサービス
• MCP プロトコル - Model Context Protocol仕様

📄 ライセンス

MIT