Tlon Urbit Messenger

🚀 Tlon MCP 服務器

Tlon MCP 服務器是一個提供與 Tlon 代理交互工具的 MCP（模型上下文協議）服務器，能夠幫助用戶實現與 Tlon 代理的便捷交互，如發送消息、查看消息歷史等。

🚀 快速開始

演示

您可以通過以下鏈接查看演示： 演示鏈接

功能

• send-dm 工具：通過船 ID 或暱稱向其他用戶發送直接消息
• read-dm-history 工具：從直接消息頻道中檢索最近的消息
• list-contacts 工具：獲取聯繫人及其暱稱和船 ID
• 自然語言支持：通過暱稱引用人員（例如“給 Brian 發送一條消息”）

先決條件

• Node.js (v16+)
• 運行中的 Urbit 船

✨ 主要特性

• 提供多種與 Tlon 代理交互的工具，滿足不同的使用場景。
• 支持自然語言，讓用戶的操作更加便捷。

📦 安裝指南

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 許可證。