Chronos MCP Server 🔵

Chronos MCP 服务 🔵

Chronos 是一款面向 Stellar 区块链的模型上下文协议（MCP）服务，专为与 Claude Desktop 等 AI 应用集成而设计。Chronos 为 AI 助手提供链上工具，让其能够更便捷地与 Stellar 网络交互。

概述

Chronos MCP 提供以下功能：

• 连接 Stellar 钱包： 使用密钥安全地连接到钱包。
• 列出钱包代币： 获取并列出 Stellar 钱包中持有的所有代币。
• 查询余额： 实时获取 XLM 和其他资产的余额。
• 转移资金： 轻松发起 Stellar 钱包之间的转账。

Chronos 采用可扩展设计，并作为标准 Node.js 包运行，因此易于部署、安装和集成，与 base-mcp 等其他 MCP 服务类似。

功能

• Stellar 集成： 通过 Horizon API 与 Stellar 主网全面交互。
• 轻松部署： 使用 npm 发布和安装 Chronos。
• 兼容 Claude Desktop： 更新 MCP 服务配置，即可与 Claude Desktop 无缝集成。
• 可扩展架构： 专为未来增强功能和集成新工具而设计。

前置条件

• Node.js（v14 或更高版本）
• npm
• Stellar 钱包凭据（用于连接的密钥）
• 用于与 Stellar 网络交互的互联网连接

安装

选项 1：从 npm 安装（推荐）

全局安装 Chronos：

npm install -g chronos-mcp

或使用 npx 直接运行：

npx chronos-mcp@latest

选项 2：从源代码安装

1. 克隆代码库：

   git clone https://github.com/yourusername/chronos-mcp.git
   cd chronos-mcp
   

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

4. （可选）全局链接，以便更轻松地访问：

   npm link
   

选项 3：使用 Docker

你也可以使用 Docker 运行 Chronos MCP：

1. 构建 Docker 镜像：

   docker build -t chronos-mcp .
   

2. 运行容器：

   docker run -it --rm chronos-mcp
   

如需了解使用 Docker 和 Chronos MCP 的详细说明，包括 Docker Compose 设置以及与 Claude Desktop 的集成，请参阅 Docker 使用指南。

如需了解如何在本地测试 Docker 设置，请参阅 Docker 使用指南。其中包含构建 Docker 镜像、运行容器以及使用 Docker 运行 Chronos MCP 的相关信息。

配置

环境变量

Chronos MCP 使用环境变量进行配置，尤其是 Stellar 密钥等敏感信息。开发期间，项目使用 dotenv 从 .env 文件加载环境变量。

配置环境变量：

1. 在项目根目录创建 .env 文件：

   STELLAR_SECRET_KEY=your_stellar_secret_key
   STELLAR_NETWORK=mainnet
   

2. 应用启动时会自动加载这些变量。

使用 Docker 时，可以通过以下几种方式提供环境变量：

• 使用 --env-file 标志：docker run -it --rm --env-file .env chronos-mcp
• 在 docker-compose.yml 中使用 env_file 指令
• 使用 -e 标志设置单个变量：docker run -it --rm -e STELLAR_SECRET_KEY=your_key chronos-mcp

Claude Desktop 配置

要在 Claude Desktop 中使用 Chronos，请更新以下位置的 Claude Desktop 配置文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

Claude Desktop 的配置示例：

{
  "mcpServers": {
    "stellar": {
      "command": "npx",
      "args": ["chronos-mcp@latest"],
      "env": {
        "STELLAR_NETWORK": "mainnet",
        "STELLAR_SECRET_KEY": "your_stellar_secret_key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

要通过 Docker 与 Claude Desktop 集成，可以使用：

{
  "mcpServers": {
    "stellar": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--env-file", "/path/to/your/.env", "chronos-mcp"],
      "env": {
        "STELLAR_NETWORK": "mainnet"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

用法

Chronos MCP 通过 MCP 接口提供以下工具：

connect_wallet

使用密钥连接到 Stellar 钱包。

示例命令：

“使用密钥 ______ 连接我的钱包”

---

list_tokens

列出指定 Stellar 钱包中的所有代币和资产。

示例命令：

“列出我钱包中的代币”

---

get_balances

获取 XLM 和其他资产的余额。

示例命令：

“我当前的 XLM 余额是多少？”

---

transfer_funds

将资金从你的钱包转到另一个 Stellar 钱包。

参数：

• secretKey：你的钱包密钥。
• destinationAddress：收款人的钱包地址。
• amount：要转账的金额。
• asset （可选）：要转账的资产（默认为 XLM）。

示例命令：

“向[目标钱包地址]转账 0.5 XLM”

测试

标准测试

在本地测试 Chronos MCP：

npm test

这将运行项目的测试套件，并验证服务是否按预期运行。

Docker 测试

如需在本地测试 Docker 设置，请参阅 Docker 使用指南 了解相关说明。该指南涵盖：

• 构建 Docker 镜像
• 使用 Docker Compose 运行容器
• 与 Claude Desktop 集成
• 其他 Docker 相关信息

你也可以使用随附的 test-client.js 脚本测试 Docker 容器：

node test-client.js

此脚本会向 Docker 容器发送一个简单的 MCP 请求，并显示响应。

部署

Chronos MCP 设计为标准 Node.js 包，可发布到 npm。发布后（例如通过 npm publish），Chronos 可以全局安装，也可以通过 npx 使用，就像其他 MCP 服务一样。

在生产环境中部署时，可考虑将 Chronos 封装为系统服务（使用 systemd、launchd 等），以便自动重启和监控。

扩展 Chronos

Chronos 的构建充分考虑了可扩展性。如需添加新工具：

1. 在 src/tools 文件夹中创建一个新目录。
2. 实现你的工具（包含 index.ts、schemas.ts 和 handlers.ts）。
3. 在 src/tools/index.ts 中导出你的工具。
4. 在 README 中更新工具文档和示例。
5. 编写测试，确保新工具正常工作。

许可证

本项目采用 MIT 许可证。

贡献

欢迎贡献！请参阅 CONTRIBUTING.md，了解报告问题、提交拉取请求及其他贡献说明。

────────────────────────────── 此 README 专为 Chronos MCP 编写，介绍了其作为 Node.js 包的部署方式、与 Claude Desktop 的集成，以及一套用于与 Stellar 区块链交互的全面功能。