Tlon Urbit Messenger

🚀 Tlon MCP サーバー

Tlon エージェントとのインタラクションツールを提供する MCP（モデルコンテキストプロトコル）サーバーです。

🚀 クイックスタート

このサーバーは、Tlon エージェントとのやり取りを容易にするためのツールを提供します。以下のセクションで、サーバーの機能、インストール方法、使用方法について説明します。

✨ 主な機能

• send-dm ツール：船 ID またはニックネームを使って、他のユーザーに直接メッセージを送信します。
• read-dm-history ツール：直接メッセージチャンネルから最近のメッセージを取得します。
• list-contacts ツール：連絡先とそのニックネーム、船 ID を取得します。
• 自然言語対応：ニックネームでユーザーを指定して操作ができます（例：「Brian にメッセージを送る」）。

📦 インストール

前提条件

• Node.js (v16+)
• 稼働中の Urbit 船

インストール手順

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

npm install

⚠️ 重要提示

必ずターミナルで手動で npm install を実行してください。これは、インストール出力が MCP プロトコルに干渉するのを防ぐためです。

📚 ドキュメント

設定

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

使用方法

サーバーの起動

# デフォルトの stdio トランスポートで起動
npm start

# HTTP トランスポートで起動
export MCP_TRANSPORT=http && npm start

# 開発モードで自動リロード
npm run dev

Claude Desktop との連携設定

デフォルトの stdio モードでは、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 を実行してください。

自然言語対応ツールの使用

設定が完了したら、自然言語コマンドを使って操作できます。

Brian にメッセージを送る

~sampel-palnet との最近の 50 件の DM 履歴を表示

私の連絡先は？

利用可能なツール

send-dm

他の船に直接メッセージを送信します。

パラメーター：

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

サンプルコマンド：

node send-dm.js --recipient user@example.com --message "Hello, Tlon!"

read-dm-history

直接メッセージチャンネルから最近のメッセージを取得します。

パラメーター：

• channelId：対象のチャンネル ID
• limit：取得する最大メッセージ数（オプション、デフォルトは 10）

サンプルコマンド：

node read-dm-history.js --channelId 12345 --limit 20

list-contacts

すべての連絡先とその詳細情報を取得します。

パラメーター： なし

サンプルコマンド：

node list-contacts.js

📄 ライセンス

MIT

デモ

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