使用说明

项目简介

本项目 'mcp-sol' 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 客户端提供与 Solana 区块链交互的能力。通过该 MCP 服务器，LLM 可以调用预定义的工具来查询 Solana 网络上的各种信息，例如账户余额、交易详情、区块数据等，从而增强 LLM 在 Solana 生态系统中的应用能力。

主要功能点

Solana 数据访问工具: 提供一系列工具，允许 LLM 客户端查询 Solana 区块链的实时和历史数据。
丰富的API支持: 集成了 Solana 官方 RPC API 的常用功能，覆盖账户、交易、区块、节点信息等多个方面。
易于集成: 遵循 MCP 协议标准，可以方便地与支持 MCP 协议的 LLM 客户端集成，例如 Claude。
可扩展性: 基于 'mcp.server.FastMCP' 框架构建，易于扩展和添加新的 Solana 相关工具。

安装步骤

克隆仓库 打开终端，执行以下命令克隆 'mcp-sol' 仓库到本地：

git clone [email protected]:tywenk/mcp-sol.git
cd mcp-sol

安装依赖 使用 'uv' 工具同步项目依赖：
```
uv sync
```
注意: 确保你已经安装了 'uv' 包管理器。如果未安装，请先参考 uv installation 安装。
安装 MCP 服务器 使用 'mcp' 命令安装服务器脚本 'src/server.py'：
```
mcp install src/server.py
```
注意: 确保你已经安装了 'mcp' 命令行工具。'mcp' 工具通常用于管理和安装 MCP 服务器。

服务器配置

要将 'mcp-sol' 服务器配置到 MCP 客户端（例如 Claude），你需要提供服务器的启动命令和参数。以下是一个 Claude 客户端的 JSON 配置文件示例，展示了如何配置 'mcp-sol' 服务器。你需要根据你的实际环境调整路径。

{
  "globalShortcut": "Alt+Space",
  "mcpServers": {
    "Solana Client": {  // 服务器名称，可以自定义
      "command": "/Users/{user}/.local/bin/uv", // uv 命令的绝对路径，根据你的 uv 安装路径修改
      "args": [
        "--directory",                      // 指定工作目录参数
        "/Users/{user}/Developer/mcp-sol", // mcp-sol 项目的绝对路径，根据你的项目路径修改
        "run",                              // uv run 命令
        "--with",                           // 指定运行环境参数
        "mcp",                              // 使用 mcp 运行环境
        "mcp",                              // 再次指定 mcp 命令 (可能是 uv mcp run 的结构要求)
        "run",                              // mcp run 命令
        "/Users/{user}/Developer/mcp-sol/src/server.py" // 服务器脚本 server.py 的绝对路径，根据你的项目路径修改
      ]
    }
  }
}

请务必根据你的实际 'uv' 安装路径和 'mcp-sol' 项目路径，修改 'command' 和 'args' 中的路径信息。 '{user}' 需要替换为你的用户名。

基本使用方法

启动 MCP 服务器: 完成安装和配置后，MCP 服务器会在后台启动。具体的启动方式取决于 MCP 客户端（例如 Claude）的机制。通常，当你启动 MCP 客户端并激活 MCP 功能时，配置的 MCP 服务器会自动启动。
在 LLM 客户端中使用工具: 在支持 MCP 协议的 LLM 客户端中，你可以通过自然语言指令调用 'mcp-sol' 服务器提供的工具。例如，在 Claude 中，你可以提问类似：
- "Please get the balance of Solana address '<address>'." (调用 'get_balance' 工具)
- "What is the latest transaction with signature '<signature>'?" (调用 'get_transaction' 工具)
- "Tell me the current block height on Solana." (调用 'get_block_height' 工具)
LLM 客户端会将你的自然语言指令转换为对 MCP 服务器特定工具的调用，并将服务器返回的结果反馈给你。
查看可用工具: 'README.md' 文件中 "List of tools" 部分列出了所有可用的工具名称和简要描述。你可以参考该列表了解 'mcp-sol' 服务器提供的全部功能。

注意: 本 MCP 服务器主要提供 Solana 区块链的只读查询功能。部分工具如 'request_airdrop', 'send_transaction', 'validator_exit' 需要谨慎使用，并确保你的操作符合 Solana 网络的安全规范。

关键词