Chronos MCP 服务器 🔵

Chronos 是一个模型上下文协议 (MCP) 服务器，专为 Stellar 区块链量身定制，并专门设计用于与 Claude Desktop 和类似的 AI 应用程序集成。 Chronos 使您的 AI 助手能够使用链上工具，从而简化与 Stellar 网络的交互。

概述

Chronos MCP 提供以下功能：

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

Chronos 被设计为可扩展的，并作为标准的 Node.js 包运行，允许它像其他 MCP 服务器（如 base-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
   

配置

根据需要创建配置文件或设置环境变量。 例如，要将 Chronos 与 Claude Desktop 一起使用，请更新位于以下位置的 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"
      },
      "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

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

部署

Chronos MCP 旨在作为标准的 Node.js 包运行，并且可以发布到 npm。 一旦发布（例如通过 npm publish），Chronos 就可以像任何其他 MCP 服务器一样全局安装或通过 npx 使用。

对于生产部署，请考虑将 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 区块链交互的一整套功能。