金大哥 - jupiter-mcp-server MCP 详情

article

README

🚀 木星 MCP 服务器

本项目仓库包含一个模型上下文协议 (MCP) 服务器，该服务器为 Claude 提供访问 Jupiter 的交换 API。借助此服务器，Claude 能够在 Solana 区块链上使用 Jupiter 执行获取报价、构建交换事务和发送交换事务等操作，为相关业务流程提供了有力支持。

🚀 快速开始

此 MCP 服务器为 Claude 提供了一系列工具，使其能够在 Jupiter 上实现代币交换的相关操作。以下是服务器提供的主要工具：

jupiter_get_quote：用于在 Jupiter 上获取交换代币的报价。
jupiter_build_swap_transaction：可在 Jupiter 上构建交换事务。
jupiter_send_swap_transaction：负责在 Jupiter 上发送交换事务。
jupiter_execute_swap：利用环境变量中的钱包私钥执行完整的交换。

✨ 主要特性

借助 Jupiter API（Lite API v1）执行交换，https://lite-api.jup.ag/swap/v1 提供了简化接口，可在单个请求中构建和执行交换，提升了可靠性。

📦 安装指南

从 npm（推荐）

# 全局安装
npm install -g jupiter-mcp-server

# 或使用分阶段安装
npm install --global jupiter-mcp-server

手动安装

下载源代码：

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

安装依赖项并构建模块：
```
npm install
npm run build
```
启动服务器：
```
node dist/main.js
```

💻 使用示例

基础用法

添加新的工具

要向 MCP 服务器添加新工具，可按以下步骤操作：

在 src/tools.ts 中定义工具。
在适当的处理器文件中创建相应的处理函数。
将处理器添加到 handlers 对象中，该对象位于 src/tools.ts。

📚 详细文档

配置

环境变量配置

在环境变量文件（如 .env）中添加以下内容：

LOG_LEVEL=info

JSON 配置文件

创建或修改 config.json 文件，示例如下：

{
  "tools": {
    "jupiter_get_quote": {
      "enabled": true,
      "api_key": "your_api_key_here"
    },
    "jupiter_build_swap_transaction": {
      "enabled": true,
      "network": "mainnet-beta"
    }
  }
}

故障排除

若在交换执行期间遇到错误，可按以下步骤排查：

在环境变量中设置 LOG_LEVEL=debug 以获取详细日志。
检查是否提供了有效的 Solana 私钥。
确保钱包有足够的 SOL 用于交换和支付交易费用。
验证使用了正确的输入和输出代币标识符。

开发

本地开发

克隆仓库：

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

安装依赖项并启动开发服务器：
```
npm install
npm run dev
```
测试更改：
```
npm test
```

发布到 npm

登录 npm

npm login

然后发布包：

npm publish

若要发布新版本，需先更新 package.json 中的版本：

npm version patch  # 或 minor，或 major
npm publish

🔧 技术细节

此服务器使用 Jupiter API 中的 Lite API v1（https://lite-api.jup.ag/swap/v1）来执行交换操作。Lite API 提供了简化的接口，可在单个请求中完成构建和执行交换的操作，有效提高了系统的可靠性。

📄 许可证

本项目采用 MIT 许可证。

jupiter-mcp-server