AMOCA (链上自治价值代理)

本仓库演示了用于 Solana 开发的链上自治价值代理 (AMOCA) 的实现，该实现构建于模型上下文协议 (MCP) 之上。

目录

• AMOCA (链上自治价值代理)
  • 目录
  • 什么是 AMOCA？
  • 特性
  • Solana 模型上下文协议 (MCP)
    • 什么是 MCP？
  • 前提条件
  • 安装
  • 开始使用
  • 使用示例
    • 生成配置文件
    • 将 AMOCA 与 Claude 结合使用
  • 项目结构
  • 扩展 Solana 开发的 MCP 的想法
    • 扩展的想法
    • 如何贡献
  • Helius API 工具
    • 数字资产标准 (DAS) API
    • 集合 & Mint API
    • Webhook 管理
    • 网络 & 实用工具
  • 增强的提示
  • 使用示例
    • 获取地址拥有的 NFT
    • 分析 NFT 集合
    • 监控网络状态
  • 许可证

什么是 AMOCA？

AMOCA（链上自治价值代理）是一个智能代理，通过标准化接口为 Solana 区块链开发提供增强的功能。 此实现展示了：

1. Solana 的全面 RPC 方法：

   • 基本账户操作（getBalance、getAccountInfo、getTransaction）
   • 链上存储计算（getMinimumBalanceForRentExemption）
   • 钱包操作（createWallet、importWallet）

2. DeFi 交易能力：

   • 代币余额检查（单个代币和完整投资组合分析）
   • 基于美元的直方图的代币价值分布可视化
   • 使用来自 Jupiter API 的价格数据进行投资组合价值跟踪
   • Jupiter API 集成用于代币交换
   • 报价检索和交换执行

3. 用于 Solana 开发的有用自治工作流程：

   • 交易分析提示（故障诊断、成本细分）
   • 存储成本计算
   • 访问 Solana 安装和集群的文档

4. 基于价值的链上操作验证和确认

flowchart TB
    %% Main Components
    Claude[Claude LLM]
    MCP[模型上下文协议服务器]
    User[用户]
    
    %% External APIs
    SolanaRPC[Solana RPC 端点]
    JupiterAPI[Jupiter API]
    HeliusAPI[Helius API]
    
    %% API Categories
    subgraph HeliusServices[Helius API 服务]
        DAS[数字资产标准 API]
        CollectionMint[集合 & Mint API]
        Webhooks[Webhook 管理]
        NetworkTools[网络 & 实用工具]
    end
    
    subgraph SolanaServices[Solana 服务]
        AccountOps[账户操作]
        StorageCalc[存储计算]
        WalletOps[钱包操作]
        TxAnalysis[交易分析]
    end
    
    subgraph JupiterServices[Jupiter 服务]
        PriceData[价格数据]
        TokenSwaps[代币交换]
        QuoteRetrieval[报价检索]
    end
    
    %% Core Interactions
    User <---> Claude
    Claude <---> MCP
    
    %% MCP to APIs
    MCP <---> SolanaRPC
    MCP <---> JupiterAPI
    MCP <---> HeliusAPI
    
    %% Helius API Connections
    HeliusAPI --- HeliusServices
    
    %% Solana Service Connections
    SolanaRPC --- SolanaServices
    
    %% Jupiter Service Connections
    JupiterAPI --- JupiterServices
    
    %% AMOCA Features
    MCP --- TokenBalances[代币余额检查]
    MCP --- PortfolioAnalysis[投资组合分析]
    MCP --- ValueVisualizations[价值可视化]
    MCP --- MeritValidation[基于价值的验证]
    MCP --- AutoWorkflows[自治工作流程]

特性

• Solana RPC 工具：查询账户信息、检查余额和分析交易
• 钱包管理：创建和导入 Solana 钱包
• 交易工具：执行代币交换、检查代币价格和分析投资组合
• Helius API 集成：利用 Helius 强大的 API 来增强 Solana 数据访问

Solana 模型上下文协议 (MCP)

本仓库演示了用于 Solana 开发的模型上下文协议 (MCP) 服务器的简单实现。

什么是 MCP？

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

1. Solana 的基本 RPC 方法（getBalance、getAccountInfo、getTransaction）
2. 一些用于 Solana 开发的有用提示

前提条件

• Node.js（建议 v16 或更高版本）
• pnpm 包管理器（v9.10.0 或兼容版本）
• Solana CLI（可选但推荐）

安装

克隆此仓库并安装依赖项：

git clone https://github.com/manolaz/amoca-solana-mcp-server.git
cd solana-dev-mcp
pnpm install

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

npx @modelcontextprotocol/inspector ts-node index.ts

开始使用

1. 设置环境变量：基于 .env.example 模板创建一个 .env 文件，其中包含您的 API 密钥。

cp .env.example .env
# 使用您的 API 密钥编辑 .env

2. 浏览代码：主要实现在 index.ts 中，它使用简单的获取工具和一些提示来设置 MCP 服务器。

3. 修改服务器：您可以通过添加更多工具、资源和提示来扩展服务器。

4. 测试您的实现：运行测试套件以确保一切正常工作。

pnpm test

使用示例

本节介绍如何在 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": ["<repo 的完整路径>/index.ts"]
    }
  }
}

如果您没有全局安装 ts-node：

{
  "mcpServers": {
    "solana-dev": {
      "command": "node",
      "args": ["<repo 的完整路径>/dist/index.js"]
    }
  }
}

将 AMOCA 与 Claude 结合使用

项目结构

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

扩展 Solana 开发的 MCP 的想法

此 MCP 服务器实现提供了一个基础，您可以扩展或派生该基础以满足您自己的 Solana 开发需求。 以下是一些帮助您入门的想法：

扩展的想法

1. 优先级费用估算器：添加一个工具，该工具根据最近的网络活动估算 Solana 交易的最佳优先级费用。 这可以帮助用户优化交易成本，同时确保及时处理。

2. Solana Verify 调试器：创建一个工具，通过提供有关验证过程的更详细信息来帮助调试 solana-verify 的问题。

3. Solana Security.txt 检查器：构建一个工具，该工具提取并显示给定 Solana 程序的 security.txt 文件信息，从而更容易联系程序的维护者以解决安全问题。

4. 用于程序部署的 Squads 助手：创建一个工具，该工具自动执行部署和升级 Solana 程序的过程，从而更容易跨多个环境管理程序状态。

5. Anchor-Error 解释器：开发一个工具，该工具获取错误代码并从 Anchor 错误代码数据库中查找相应的人类可读错误消息。

6. 增强的提示：扩展服务器的提示功能，以便为 Solana 开发任务提供更多上下文相关的建议。 例如，添加用于常见交易模式、账户创建或代币操作的提示。

7. 交易构建器：创建帮助构建具有多个指令的复杂交易的工具，从而更容易与各种 Solana 程序交互。

8. 自定义 RPC 端点：允许配置自定义 RPC 端点，包括支持私有 RPC 提供程序或本地验证器。

9. 程序部署助手：创建简化部署和升级 Solana 程序过程的工具。

10. 账户 & 交易浏览器：添加一个工具，该工具获取账户或交易 ID 并以人类可读的格式显示内容，类似于浏览器视图。 这对于检查交易数据或账户状态非常有用，而无需手动解码数据。

11. Solana、Anchor 和协议文档：添加将 Solana、Anchor 和协议文档直接加载到 MCP 编辑器中的资源，从而无需离开编辑器即可轻松访问相关信息。 这可以通过从各自的仓库中获取文档并将其作为 MCP 服务器的资源来提供来实现。

如何贡献

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

1. 保持代码的良好文档记录
2. 为新功能包含测试
3. 遵循现有的代码风格
4. 使用有关您的添加的信息更新 README

Helius API 工具

本项目集成了各种 Helius API 端点，以实现强大的 Solana 数据访问：

数字资产标准 (DAS) API

工具	描述
getAssetsByOwner	获取特定地址拥有的 NFT
getAsset	获取有关特定 NFT 的详细信息（按其 ID）
getAssetsByGroup	获取属于特定组（如集合）的资产
searchAssets	使用复杂的查询参数搜索资产
getAssetProof	获取压缩 NFT 的 Merkle 证明
getAssetsByCreator	获取由特定创建者地址创建的资产
getAssetsByAuthority	按更新授权地址获取资产
getNftEditions	获取主版本 NFT 的所有版本

集合 & Mint API

工具	描述
getMintlist	获取集合的 Mint 列表

Webhook 管理

工具	描述
getAllWebhooks	获取您的 Helius API 密钥的所有 Webhook
getWebhookByID	按 Webhook ID 获取 Webhook 详细信息
createWebhook	创建一个新的 Webhook 以进行地址活动监控
createCollectionWebhook	创建一个 Webhook 以监控 NFT 集合
deleteWebhook	按其 ID 删除 Webhook

网络 & 实用工具

工具	描述
getCurrentTPS	获取 Solana 上的当前每秒交易数
getTokenHolders	按 Mint 地址获取特定代币的持有者
getPriorityFeeEstimate	获取交易的估计优先级费用
getStakeAccounts	按其所有者地址获取质押账户
getComputeUnits	模拟交易以获取消耗的总计算单元

增强的提示

服务器包括用于常见 Helius 相关任务的专用提示：

提示	描述
collection-analysis	获取 NFT 集合的详细分析
monitor-nft-collection	设置一个 Webhook 以监控 NFT 集合活动
network-status	获取 Solana 网络状态信息

使用示例

获取地址拥有的 NFT

const response = await server.tools.getAssetsByOwner({
  ownerAddress: "GoodboiNft5iFNhbgKkf1RX2VdMqKvt5xYxyVh3zf9okx",
});

分析 NFT 集合

const response = await server.prompts["collection-analysis"]({
  collectionAddress: "J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w",
});

监控网络状态

const response = await server.prompts["network-status"]({});

许可证

MIT