Solana 模型上下文协议 (MCP) 演示

本仓库展示了为 Solana 开发实现的一个简单的模型上下文协议 (MCP) 服务器。

什么是 MCP？

模型上下文协议 (MCP) 是一个标准化接口，用于 AI 模型与工具和资源进行交互。本演示展示了一个简单的 MCP 服务器实现，提供了以下功能：

Solana 的基本 RPC 方法（getBalance、getAccountInfo、getTransaction）
一些对 Solana 开发有帮助的提示

前提条件

Node.js（建议使用 v16 或更高版本）
pnpm 包管理器（v9.10.0 或兼容版本）

安装

克隆本仓库并安装依赖：

git clone https://github.com/solana-foundation/solana-dev-mcp.git
cd solana-dev-mcp
pnpm install

要在 MCP 检查器中运行此服务器，请使用：

npx @modelcontextprotocol/inspector ts-node index.ts

快速开始

探索代码：主要实现在 index.ts 中，它设置了一个带有简单获取工具和一些提示的 MCP 服务器。
修改服务器：您可以通过添加更多工具、资源和提示来扩展服务器。
获取扩展灵感：查看扩展 MCP 以支持 Solana 开发的思路部分，获取添加新工具和资源的灵感。

示例用法

本节解释了如何在 Claude 中使用 Solana MCP 服务器。按照相同的步骤在 Windsurf 和 Cursor 中使用 Solana MCP 服务器。

生成配置文件

要使用此 Solana MCP 服务器，您需要生成一个配置文件，供 Claude 连接到服务器。运行以下命令之一以生成配置文件：

如果您已全局安装 ts-node，请运行 pnpm generate-config
如果您未全局安装 ts-node，请运行 pnpm build && pnpm generate-config:js

这将打印出以下内容的 JSON 配置：

如果您有 ts-node：

{
  "mcpServers": {
    "solana-dev": {
      "command": "ts-node",
      "args": ["<full-path-to-repo>/index.ts"]
    }
  }
}

如果您未全局安装 ts-node：

{
  "mcpServers": {
    "solana-dev": {
      "command": "node",
      "args": ["<full-path-to-repo>/dist/index.js"]
    }
  }
}

项目结构

index.ts - 主服务器实现
package.json - 项目依赖和元数据
tsconfig.json - TypeScript 配置

扩展 MCP 以支持 Solana 开发的思路

此 MCP 服务器实现为您提供了一个基础，您可以扩展或分叉以满足自己的 Solana 开发需求。以下是一些启发您的思路：

扩展思路

优先费用估算器：添加一个工具，根据最近的网络活动估算 Solana 交易的最佳优先费用。这可以帮助用户优化交易成本，同时确保及时处理。
Solana 验证调试器：创建一个工具，通过提供有关验证过程的更详细信息来帮助调试 solana-verify 的问题。
Solana Security.txt 检查器：构建一个工具，提取并显示给定 Solana 程序的 security.txt 文件信息，使维护者更容易联系到安全问题。
用于程序部署的 Squads 助手：创建一个工具，自动化部署和升级 Solana 程序的过程，使跨多个环境管理程序状态更加容易。
Anchor 错误解释器：开发一个工具，接收错误代码并从 Anchor 错误代码数据库中查找相应的人类可读错误消息。
增强提示：扩展服务器的提示功能，为 Solana 开发任务提供更多上下文感知的建议。例如，添加常见交易模式、账户创建或代币操作的提示。
交易构建器：创建工具，帮助构建包含多个指令的复杂交易，使与各种 Solana 程序的交互更加容易。
自定义 RPC 端点：允许配置自定义 RPC 端点，包括支持私有 RPC 提供商或本地验证器。
程序部署助手：创建工具，简化部署和升级 Solana 程序的过程。
账户和交易浏览器：添加一个工具，接收账户或交易 ID 并以人类可读的格式显示内容，类似于浏览器视图。这对于检查交易数据或账户状态非常有用，而无需手动解码数据。
Solana、Anchor 和协议文档：添加资源，将 Solana、Anchor 和协议文档直接加载到 MCP 编辑器中，提供对相关信息的轻松访问，而无需离开编辑器。这可以通过从各自的仓库获取文档并将其作为 MCP 服务器的资源来实现。

如何贡献

如果您构建了一个可能对他人有用的扩展，请考虑向本仓库提交拉取请求。请确保遵循以下准则：

保持代码的良好文档
为新功能包含测试
遵循现有的代码风格
在 README 中更新有关您添加内容的信息

安全性

这是一个简单的示例，不应在生产环境中使用。
MCP 是一个新标准，缺乏适当的安全措施。

在安装和尝试来自未知开发者的 MCP 服务器时，请务必非常小心。

请使用沙盒环境来尝试 MCP 服务器，其中不包含关键信息，以防止潜在的损害。