模型上下文协议服务器

Tlon MCP服务器是一个提供与Tlon代理交互工具的服务,支持直接消息发送、消息历史读取和联系人管理等功能,适用于Urbit生态系统中的通信需求。

  • by jamesacklin
  • JavaScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 jamesacklin/tlon-mcp-server

使用说明

Tlon MCP服务器

MCP(模型上下文协议)服务器,提供与Tlon代理交互的工具。

演示

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

特性

  • 发送dm工具:通过船只ID或昵称向其他用户发送直接消息
  • 读取dm历史记录工具:从直接消息通道检索最近的消息
  • 列表联系人工具:获取联系人的昵称和船只ID
  • 自然语言支持:通过昵称推荐人(“给Brian发信息”)

先决条件

  • Node.js(v16+)
  • 一艘行驶中的Urbit船

安装

  1. 克隆存储库
  2. 导航到项目目录
  3. 安装依赖项:
npm install

重要提示: 始终运行 npm install 在与Claude Desktop或任何其他MCP客户端一起使用之前,请在终端中手动操作。这可以防止安装输出干扰MCP协议。

配置

使用环境变量配置服务器:

变量 描述 默认值
URBIT_SHIP 您的Urbit船名(不含~) zod
URBIT_CODE 您的Urbit+代码 lidlut标签pillex ridrup
URBIT_HOST Urbit主机 本地主机
URBIT_PORT 乌尔比港 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"]
    }
  }
}

重要提示: 一定要跑 npm install 在配置Claude Desktop之前,请先在服务器目录中。

使用自然语言工具

配置后,您可以使用自然语言命令:

Send a message to Brian
Show me my recent DM history with ~sampel-palnet
Who are my contacts?

可用工具

发送dm

向另一艘船发送直接信息。

参数:

  • recipient:收件人的船名(带~)或昵称
  • message:要发送的消息文本

示例用法:

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

读取dm历史记录

从您的船和另一艘船之间的直接消息通道获取最新消息。

参数:

  • correspondent:另一艘船的名称(带~)或昵称
  • count (可选):返回多少条消息(默认100条,最多500条)
  • format (可选):输出格式-“原始”或“格式化”(默认“格式化”)

示例用法:

Show me my last 50 messages with Dad

列出联系人

使用船只ID和昵称检索您的联系人列表。

参数:

  • format (可选):输出格式-“原始”或“格式化”(默认“格式化”)

示例用法:

List all my contacts

许可证

麻省理工学院