Tlon MCP Server

Tlon MCP サーバー

Tlon エージェントとやり取りするためのツールを提供する MCP（Model Context Protocol）サーバーです。

デモ

https://github.com/user-attachments/assets/765847b2-df40-44c0-bfd3-c23eb609bbd8

機能

• send-dm ツール：船の ID またはニックネームで他のユーザーにダイレクトメッセージを送信します
• read-dm-history ツール：ダイレクトメッセージチャンネルから最近のメッセージを取得します
• list-contacts ツール：ニックネームと船の ID を含む連絡先を取得します
• 自然言語に対応：ニックネームで相手を指定できます（「ブライアンにメッセージを送って」）

前提条件

• Node.js（v16+）
• 稼働中の Urbit 船

インストール

1. リポジトリをクローンします
2. プロジェクトディレクトリに移動します
3. 依存関係をインストールします：

npm install

重要： Claude Desktop やその他の MCP クライアントで使用する前に、必ずターミナルで npm install を実行してください。これにより、インストール時の出力が MCP プロトコルに干渉するのを防げます。

設定

環境変数を使ってサーバーを設定します：

変数	説明	デフォルト
URBIT_SHIP	Urbit の船名（~ を除く）	zod
URBIT_CODE	Urbit の +コード	lidlut-tabwed-pillex-ridrup
URBIT_HOST	Urbit のホスト	localhost
URBIT_PORT	Urbit のポート	8080
PORT	MCP サーバーのポート（HTTP モードのみ）	3001
MCP_TRANSPORT	トランスポートの種類（http または stdio）	stdio

使い方

サーバーの起動

# Start with default stdio transport
npm start

# Start with HTTP transport
export MCP_TRANSPORT=http && npm start

# Development mode with auto-reload
npm run dev

Claude Desktop でのセットアップ

デフォルトの stdio モードは Claude Desktop とシームレスに動作します。次の場所にある Claude Desktop の設定ファイルを作成または編集します：

~/Library/Application Support/Claude/claude_desktop_config.json

次の内容を記述します：

{
  "mcpServers": {
    "tlon-mcp": {
      "command": "/bin/sh",
      "args": ["-c", "cd /path/to/server && node index.js"]
    }
  }
}

重要： Claude Desktop を設定する前に、必ずサーバーディレクトリで npm install を実行してください。

自然言語でのツールの使用

設定が完了したら、自然言語のコマンドを使用できます：

Send a message to Brian

Show me my recent DM history with ~sampel-palnet

Who are my contacts?

利用可能なツール

send-dm

別の船にダイレクトメッセージを送信します。

パラメーター：

• recipient：受信者の船名（~ 付き）またはニックネーム
• message：送信するメッセージ本文

使用例：

Send a message to Brian saying "Let's meet tomorrow"

read-dm-history

自分の船と別の船の間のダイレクトメッセージチャンネルから最新のメッセージを取得します。

パラメーター：

• correspondent：相手の船名（~ 付き）またはニックネーム
• count（任意）：取得するメッセージ数（デフォルトは 100、最大 500）
• format（任意）：出力形式（「raw」または「formatted」、デフォルトは「formatted」）

使用例：

Show me my last 50 messages with Dad

list-contacts

船の ID とニックネームを含む連絡先リストを取得します。

パラメーター：

• format（任意）：出力形式（「raw」または「formatted」、デフォルトは「formatted」）

使用例：

List all my contacts

ライセンス

MIT