Narwhal

Narwhal API MCP ブリッジ

@narwhalapi/mcp は、ローカルコマンドを起動する MCP クライアントを、ホストされた Narwhal API MCP サーバーに接続します。stdio ブリッジとして動作し、API キーを Bearer トークンとして使用して、すべてのリクエストを https://api.narwhalapi.com/mcp に転送します。このブリッジ自体はツールを持たず、ツールの一覧はサーバーから取得します。

インストール

Node.js 20 以降が必要です。

npm install @narwhalapi/mcp

クイックスタート

ローカルコマンドに対応している MCP クライアントに、次の設定を追加します。

{
  "mcpServers": {
    "narwhal": {
      "command": "npx",
      "args": ["-y", "@narwhalapi/mcp"],
      "env": {
        "NARWHAL_API_KEY": "your-key"
      }
    }
  }
}

your-key を API キーに置き換えてください。MCP クライアントは npx でブリッジを起動し、stdio 経由で通信します。その後、リクエストはそのキーを使ってホストされたサーバーに送信されます。

設定

NARWHAL_API_KEY は必須です。設定されていない場合、ブリッジはメッセージを表示して終了します。 NARWHAL_BASE_URL のデフォルト値は https://api.narwhalapi.com です。 NARWHAL_TIMEOUT はリクエストのタイムアウトをミリ秒単位で設定し、デフォルト値は 10000 です。ログは stderr にのみ出力され、stdout は MCP 通信用に確保されます。

リモート接続

リモートサーバーに対応している MCP クライアントは、 https://api.narwhalapi.com/mcp に直接接続できます。API キーを指定して Authorization: Bearer <key> ヘッダーを設定してください。直接接続では、ローカルブリッジを起動せずにホストされたサーバーを利用できます。MCP クライアントが対応している接続方法を選択してください。

リンク：ドキュメント

MIT ライセンス