Chronos MCP服务器🔵
Chronos是为Stellar区块链量身定制的模型上下文协议（MCP）服务器，专为与Claude Desktop和类似的AI应用程序集成而设计。Chronos为您的AI助手提供链上工具，使其能够与Stellar网络进行简化交互。
概述
Chronos MCP提供以下功能：
- 连接到恒星钱包： 使用密钥安全连接到您的钱包。
- 列出钱包代币： 检索并列出Stellar钱包中持有的所有代币。
- 查询余额： 获取XLM和其他资产的实时余额。
- 转账资金： 轻松启动Stellar钱包之间的转账。
Chronos被构建为可扩展的，并作为标准的Node.js包运行，使其易于部署、安装和集成——类似于其他MCP服务器，如base MCP。
特性
- 恒星集成： 通过Horizon API与Stellar主网进行全面交互。
- 易于部署： 使用npm发布并安装Chronos。
- Claude桌面兼容性： 通过更新MCP服务器配置，与Claude Desktop无缝集成。
- 可扩展架构： 专为未来的增强功能和新工具集成而设计。
先决条件
- Node.js（v14或更高版本）
- npm
- 恒星钱包凭据（连接密钥）
- 与Stellar网络交互的互联网连接
安装
选项1：从npm安装（推荐）
全局安装Chronos：
npm install -g chronos-mcp或者直接与npx一起使用：
npx chronos-mcp@latest选项2：从源代码安装
- 克隆存储库：
git clone https://github.com/yourusername/chronos-mcp.git
cd chronos-mcp- 安装依赖项：
npm install- 构建项目：
npm run build- （可选）全球链接，便于访问：
npm link选项3：使用Docker
您还可以使用Docker运行Chronos MCP：
- 构建Docker镜像：
docker build -t chronos-mcp .- 运行容器：
docker run -it --rm chronos-mcp有关将Docker与Chronos MCP一起使用的更多详细说明，包括Docker Compose设置和与Claude Desktop的集成，请参阅 .
有关在本地测试Docker设置的信息，请参阅 。这包括有关构建Docker镜像、运行容器以及将Docker与Chronos MCP一起使用的信息。
配置
环境变量
Chronos MCP使用环境变量进行配置，特别是对于恒星密钥等敏感信息。该项目使用 dotenv 从加载环境变量 .env 开发过程中的文件。
要配置环境变量，请执行以下操作：
- 创建一个
.env项目根目录中的文件：
STELLAR_SECRET_KEY=your_stellar_secret_key
STELLAR_NETWORK=mainnet- 这些变量将在应用程序启动时自动加载。
使用Docker时，您可以通过多种方式提供环境变量：
- 使用
--env-file标志：docker run -it --rm --env-file .env chronos-mcp - 使用
env_filedocker-compose.yml中的指令 - 使用设置单个变量
-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 - 窗户：
%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_tokes
列出指定Stellar钱包中的所有代币和资产。
命令示例：
“列出我的钱包代币”
______________________________________________________________________
get_balances
检索XLM和任何其他资产的余额。
命令示例：
“我目前的XLM余额是多少？”
______________________________________________________________________
转账_资金
将资金从您的钱包转移到另一个Stellar钱包。
参数：
secretKey：你的钱包密钥。destinationAddress：收件人的钱包地址。amount：要转账的金额。asset*（可选）*：要转移的资产（默认为XLM）。
命令示例：
“将0.5 XLM转账至\[目标钱包地址\]”
测试
标准测试
要在本地测试Chronos MCP：
npm test这将运行项目的测试套件，并验证您的服务器是否按预期工作。
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在构建时考虑了可扩展性。要添加新工具，请执行以下操作：
- 在中创建一个新目录
src/tools文件夹。 - 实施你的工具（包括
index.ts,schemas.ts，以及handlers.ts). - 将工具导出到
src/tools/index.ts. - 使用工具的文档和示例更新README。
- 编写测试以确保新工具正常工作。
许可证
该项目根据 MIT许可证.
贡献
欢迎投稿！请咨询 贡献.md 有关报告问题、提交拉取请求和其他贡献说明的指导方针。
────────────────────────────── 本自述专为Chronos MCP量身定制，概述了其作为Node.js包的部署、与Claude Desktop的集成以及与Stellar区块链交互的一套全面功能。