Chronos MCP Server

Chronos MCP 服务器

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

概述

Chronos MCP 提供以下功能：

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

Chronos 具有可扩展性，可作为标准 Node.js 包运行，因此可以轻松部署、安装和集成 - 类似于其他 MCP 服务器（如 base-mcp）。

特征

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

先决条件

• Node.js（v14 或更高版本）
• npm
• 恒星钱包凭证（连接密钥）
• 互联网连接与恒星网络交互

安装

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

全局安装 Chronos：

或者直接通过 npx 使用：

选项 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 映像、运行容器以及测试其功能的说明。

配置

环境变量

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桌面配置

要将 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 的示例配置：

对于 Docker 与 Claude Desktop 的集成，您可以使用：

用法

Chronos MCP 通过其 MCP 接口公开以下工具：

连接钱包

使用密钥连接到 Stellar 钱包。

示例命令：

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

列表令牌

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

示例命令：

“列出我的钱包代币”

获取余额

检索 XLM 和任何其他资产的余额。

示例命令：

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

转账

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

参数：

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

示例命令：

“将 0.5 XLM 转移到 [目标钱包地址]”

测试

标准测试

要在本地测试 Chronos MCP：

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

Docker 测试

要在本地测试 Docker 设置，请参阅Docker 测试指南以获取详细说明。该指南涵盖以下内容：

• 构建 Docker 镜像
• 使用 Docker Compose 运行容器
• 测试容器功能
• 常见问题故障排除

您还可以使用包含的test-client.js脚本来测试 Docker 容器：

该脚本向 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文件，了解如何报告问题、提交拉取请求以及其他贡献说明。

────────────────────────────────── 本自述文件专为 Chronos MCP 量身定制，概述了其作为 Node.js 包的部署、与 Claude Desktop 的集成以及与 Stellar 区块链交互的综合功能集。