Osmosis Agent Toolkit MCP服务器使用说明

项目简介

Osmosis Agent Toolkit MCP服务器是一个基于Model Context Protocol (MCP) 构建的应用后端，旨在为大型语言模型 (LLM) 提供与Osmosis区块链交互的能力。通过此MCP服务器，LLM应用可以安全、便捷地获取Osmosis区块链上的账户信息，进行代币兑换交易等操作。

主要功能点

账户信息查询: 获取Osmosis区块链账户的地址和资产余额。
代币兑换报价: 查询指定交易对的代币兑换最优报价，支持按买入数量和卖出数量两种方式查询。
代币兑换交易: 根据报价信息，在Osmosis区块链上执行代币兑换交易。

安装步骤

安装 Bun: 确保您的系统已安装 Bun 包管理器。如果未安装，请访问 https://bun.sh/ 按照官方指引进行安装。

克隆仓库: 使用Git克隆 Osmosis Agent Toolkit 仓库到本地：

git clone https://github.com/jonator/osmosis-agent-toolkit.git

进入目录: 切换到克隆的仓库目录：

cd osmosis-agent-toolkit

安装依赖: 使用 Bun 安装项目依赖：
```
bun i
```
构建项目: 构建项目代码：
```
bun run build
```

服务器配置

要将 Osmosis Agent Toolkit MCP 服务器配置到 MCP 客户端（例如 Claude Desktop 或 Cursor），您需要提供服务器的启动命令和参数。以下是配置示例，请根据您的实际情况进行调整。

{
    "mcpServers": {
        "Osmosis": {
            "command": "npx",
            "args": [
                "-y",
                "@osmosis-agent-toolkit/mcp"
            ],
            "env": {
                "OSMOSIS_MNEMONIC": "<your mnemonic here>"  // 请替换为您的 Osmosis 助记词，请务必安全管理您的助记词！
            }
        }
    }
}

配置参数说明:

'"Osmosis"': MCP 服务器的名称，可以自定义。
'"command": "npx"': 指定用于启动服务器的命令为 'npx'，它允许您执行本地或项目依赖的 npm 包。
'"args": ["-y", "@osmosis-agent-toolkit/mcp"]': 传递给 'npx' 的参数。
- '"-y"': 'npx' 的参数，表示自动确认安装 '@osmosis-agent-toolkit/mcp' 包（如果尚未安装）。
- '"@osmosis-agent-toolkit/mcp"': 指定要执行的 npm 包，即 Osmosis Agent Toolkit MCP 服务器的入口。
'"env": { "OSMOSIS_MNEMONIC": "<your mnemonic here>" }': 设置环境变量。
- '"OSMOSIS_MNEMONIC": "<your mnemonic here>"': 重要 - 您需要将 '<your mnemonic here>' 替换为您的 Osmosis 钱包助记词。请务必妥善保管您的助记词，避免泄露！ 建议通过环境变量而不是硬编码的方式传递助记词，以提高安全性。

请注意: MCP客户端会读取此JSON配置，并根据配置信息启动 Osmosis Agent Toolkit MCP 服务器。服务器启动后，MCP客户端即可通过 MCP 协议与之通信，调用服务器提供的功能。

基本使用方法

启动 MCP 客户端: 启动您配置了 Osmosis Agent Toolkit MCP 服务器的 MCP 客户端 (例如 Claude Desktop 或 Cursor)。
在 LLM 中使用工具: 在 LLM 的交互界面中，您可以指示 LLM 使用以下工具来与 Osmosis 区块链进行交互：
- 'getAccount': 查询账户信息（地址、余额）。
- 'getSwapQuoteInGivenOut': 获取指定输出代币数量的兑换报价（输入代币数量未知）。
- 'getSwapQuoteOutGivenIn': 获取指定输入代币数量的兑换报价（输出代币数量未知）。
- 'sendSwapInGivenOutTx': 执行按输出代币数量的兑换交易。
- 'sendSwapOutGivenInTx': 执行按输入代币数量的兑换交易。
例如，您可以向 LLM 提问： "我的 Osmosis 账户余额是多少？" 或 "我想用 10 个 ATOM 兑换成 OSMO，现在汇率是多少？"。 LLM 应该能够识别您的意图，并调用相应的工具来获取信息或执行操作。

重要安全提示: 请务必妥善保管您的 Osmosis 钱包助记词，切勿在不信任的环境中配置或使用，以防止资产泄露风险。

关键词