MCP Connector

MCP Connector

MCP Connector は、複数の Model Context Protocol（MCP）サーバーを実行・管理できる軽量サーバーです。TypingMind との連携を目的として設計されています。ローカルコンピューターまたはリモートサーバーで MCP サーバーを簡単に実行でき、シンプルな REST API を通じてカスタム AI モデルやツールを TypingMind に接続できます。

---

ローカルデバイスでの実行方法

npx を使うと、MCP Connector をすぐに起動できます（インストール不要です）。

npx @typingmind/mcp <auth-token>

• <auth-token> を TypingMind から提供された認証トークンに置き換えてください。

TypingMind の利用中は、このターミナルウィンドウを開いたままにしてください。

HTTPS のサポート

HTTPS を有効にするには、次の環境変数を設定してください。

CERTFILE=./path/to/certificate.crt KEYFILE=./path/to/privatekey.key npx @typingmind/mcp <auth-token>

• CERTFILE：SSL 証明書ファイルへのパス
• KEYFILE：SSL 秘密鍵ファイルへのパス

両方の変数を設定すると、サーバーは HTTP ではなく HTTPS を使用します。

---

サーバーでの実行方法

MCP Connector をリモートサーバーで実行する場合は、次の手順に従ってください。

1. Node.js（バージョン 14 以降）をインストールします。

2. npx を使ってサーバーを実行します。

   npx @typingmind/mcp <auth-token>
   

   HTTPS で実行する場合：

   CERTFILE=./path/to/certificate.crt KEYFILE=./path/to/privatekey.key npx @typingmind/mcp <auth-token>
   

   また、実行を継続する場合（SSH を終了した後など）は、pm2 や screen／tmux などのプロセスマネージャーを使用できます。

   pm2 start npx -- @typingmind/mcp <auth-token>
   

---

TypingMind への接続方法

MCP Connector を TypingMind に接続するには、次の手順に従ってください。

1. www.typingmind.com/mcp の手順に従います。
2. TypingMind の MCP 統合ページで、MCP Connector のサーバーアドレス（http://localhost:<port> またはサーバーの IP アドレスとポート）と認証トークンを入力します。

---

REST API エンドポイント

すべての API エンドポイントでは、サーバー起動時に指定した Bearer トークンによる認証が必要です。

エンドポイント	メソッド	説明
/ping	GET	ヘルスチェック。{ status: "ok" } を返します
/start	POST	1 つ以上の MCP クライアントを起動します。本文：{ mcpServers: { ... } }
/restart/:id	POST	指定したクライアントを再起動します
/clients	GET	実行中のすべての MCP クライアントとそのツールを一覧表示します
/clients/:id	GET	指定したクライアントの情報を取得します
/clients/:id/tools	GET	クライアントで利用可能なツールを一覧表示します
/clients/:id/call_tools	POST	クライアントのツールを呼び出します。本文：{ name, arguments }
/clients/:id	DELETE	クライアントを停止して削除します

注意：

• すべてのリクエストに Authorization: Bearer <auth-token> ヘッダーが必要です。
• 利用可能なポート：サーバーはポート 50880 または 50881 を選択します。これらのポートがシステムで使用可能であることを確認してください。PORT 環境変数を使って別のポートを指定することもできます。

---

ライセンス

MIT