solana-mcp-vybe README

项目的 README,来自 github.com/vybenetwork/solana-mcp-vybe。合并为一个 markdown 文件:README.md。

Solana MCP by Vybe

Solana MCP by Vybe is a developer toolkit for live Solana data: wallets, trades, markets, transfers, and signable swaps. The public server publishes 44 tools. Each tool calls one Vybe API endpoint.

build-swap, build-close-token-accounts, and build-withdraw-mev return an unsigned transaction to sign in your own wallet. The server does not take private keys, and it does not broadcast transactions. get-x402-access-guide returns x402 pay-per-call instructions and does not send a payment.

This repo is the directory listing, Claude plugin, and MCP registry metadata. The running server is vybenetwork/vybe-mcp-oauth-proxy. Its current version is 1.3.2.

Versions

Piece Version Where
Live MCP server 1.3.2 initialize on https://mcp.vybenetwork.xyz/mcp
Claude plugin 1.3.0 .claude-plugin/plugin.json
MCP registry metadata 1.1.3 server.json

MCP endpoint

Use the streamable HTTP endpoint:

https://mcp.vybenetwork.xyz/mcp

Registry metadata (server.json) publishes the remote as:

https://mcp.vybenetwork.xyz

Clients that require an explicit MCP path (ChatGPT Developer Mode, Codex, Cursor HTTP) should use https://mcp.vybenetwork.xyz/mcp.

The public guide at docs.vybenetwork.com/docs/mcp still describes the old tools list-endpoints, search-endpoints, get-endpoint, and execute-request. Those names are not in the published tool list.

Quick setup

Cursor / Windsurf / Codex-style HTTP

{
  "mcpServers": {
    "solana-mcp-vybe": {
      "type": "http",
      "url": "https://mcp.vybenetwork.xyz/mcp"
    }
  }
}

Same snippet: .mcp.json.

Claude Desktop via mcp-remote

{
  "mcpServers": {
    "solana-mcp-vybe": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.vybenetwork.xyz/mcp"]
    }
  }
}

Claude.ai custom connector or Connectors Directory

Name: Solana MCP by Vybe
URL:  https://mcp.vybenetwork.xyz/mcp

Claude Code / Cowork plugin

This repo is a Claude plugin (/.claude-plugin/plugin.json). Validate, then submit the public GitHub URL:

claude plugin validate .

Sign in with OAuth when the client asks. Use your Vybe email as the username and your API key as the password, then approve consent. Do not commit API keys or private keys into this repo.

Claude directory links from .claude-plugin/plugin.json:

Classification on that manifest: acts on apis, finances, code, and databases, department engineering, industry software-saas, subject computing. claude plugin validate on Claude Code 2.1.138 reports the directory-only fields (displayName, icon, links, classification) as unrecognized. The plugin directory accepts them.

What this repository holds

Available tools

Published tools/list has these 44 tools. Pass each tool's own arguments. Do not pass a URL, path, or HTTP method.

Tool Calls
list-pyth-price-feeds GET /v4/oracle/pyth/pricefeeds
get-pyth-price-candles GET /v4/oracle/pyth/pricefeeds/{priceFeedAddress}/candles
get-pyth-price GET /v4/oracle/pyth/pricefeeds/{priceFeedAddress}/price
get-market GET /v4/markets/{marketAddress}
list-markets GET /v4/markets
get-market-candles GET /v4/markets/{marketAddress}/candles
get-pyth-price-history GET /v4/oracle/pyth/pricefeeds/{priceFeedAddress}/price-ts
get-pyth-product GET /v4/oracle/pyth/products/{productAddress}
get-token-candles GET /v4/tokens/{mintAddress}/candles
list-tokens GET /v4/tokens
list-labeled-programs GET /v4/programs/labeled-program-accounts
list-supported-dexes GET /v4/reference/dexes
get-token-liquidity GET /v4/tokens/{mintAddress}/liquidity
get-token GET /v4/tokens/{mintAddress}
get-token-holder-count-history GET /v4/tokens/{mintAddress}/holders-count-ts. Requires startTime and endTime as unix seconds, at most 2592000 seconds (30 days) apart. interval is hour or day.
list-instruction-names GET /v4/reference/instruction-names
get-token-trader-activity GET /v4/tokens/{mintAddress}/trader-activity
get-token-top-pnl-traders GET /v4/tokens/{mintAddress}/top-pnl-traders
get-token-top-holders GET /v4/tokens/{mintAddress}/top-holders
list-transfers GET /v4/transfers
get-swap-quote GET /v4/trading/swap-quote
get-token-trade-volume-history GET /v4/tokens/{mintAddress}/trade-volume-ts
build-swap POST /v4/trading/swap
list-trades GET /v4/trades
get-empty-accounts-batch POST /v4/wallets/batch/empty-accounts
get-dust-accounts-batch POST /v4/wallets/batch/dust-accounts
get-token-balance-history-batch POST /v4/wallets/batch/token-balances-ts
get-token-balances-batch POST /v4/wallets/batch/token-balances
list-top-traders GET /v4/wallets/top-traders
get-wallet-counterparties GET /v4/wallets/{ownerAddress}/counterparties
list-labeled-accounts GET /v4/wallets/labeled-accounts
get-token-accounts-batch POST /v4/wallets/batch/token-accounts-balance-ts
get-wallet-defi-positions GET /v4/wallets/{ownerAddress}/defi-positions
get-wallet-empty-accounts GET /v4/wallets/{ownerAddress}/empty-accounts
get-wallet-dust-accounts GET /v4/wallets/{ownerAddress}/dust-accounts
get-wallet-token-account-history GET /v4/wallets/{ownerAddress}/token-accounts-balance-ts
get-wallet-token-balances GET /v4/wallets/{ownerAddress}/token-balance
get-wallet-pnl GET /v4/wallets/{ownerAddress}/pnl
get-wallet-pnl-history GET /v4/wallets/{ownerAddress}/pnl-ts
get-wallet-token-balance-history GET /v4/wallets/{ownerAddress}/token-balance-ts
build-close-token-accounts POST /v4/wallets/util/close-token-accounts
get-wallet-transfer-volume GET /v4/wallets/{ownerAddress}/transfer-volume-usd
build-withdraw-mev POST /v4/wallets/util/withdraw-mev
get-x402-access-guide Static x402 pay-per-call guidance. Does not send a payment.

build-swap, build-close-token-accounts, and build-withdraw-mev return an unsigned transaction. They do not sign or broadcast it. The five *-batch tools POST a list of wallet addresses and only read data.

GitHub repository name

vybenetwork/solana-mcp-vybe (starts with solana-mcp, includes Vybe).

Publish a new listing version

  1. Clone or use this repo at github.com/vybenetwork/solana-mcp-vybe

  2. Tag and push (the workflow sets server.json version from the tag):

    git tag vX.Y.Z
    git push origin vX.Y.Z
    

    server.json is currently 1.1.3. The next registry tag should be newer than that. A tag push rewrites server.json version from the tag during the workflow.

    Or run Actions → Publish to MCP Registry → Run workflow (uses the version already in server.json).

Publishing uses GitHub OIDC in Actions; no personal token secret is required.

If you use mcp-publisher login github locally and get 403 for io.github.vybenetwork/...: Git apps like Git Credential Manager are unrelated. Open GitHub → Settings → Applications → Authorized OAuth Apps, choose the app you authorized during mcp-publisher login github (device flow), then under Organization access click Grant for vybenetwork. On SAML-enforced orgs, also complete SSO for that OAuth app. Then run mcp-publisher logout, mcp-publisher login github, and publish again.

  1. Verify:

    curl -sS "https://registry.modelcontextprotocol.io/v0.1/servers?search=vybenetwork" | jq .
    

Cursor and other directories

Use .mcp.json as the install snippet. For Cursor Directory, submit after the registry publish succeeds; use OAuth for https://mcp.vybenetwork.xyz/mcp.

Registry catalog id

server.json name: io.github.vybenetwork/solana-mcp-vybe. Display title: Solana MCP by Vybe.

Publish: push main, then git tag vX.Y.Z && git push origin vX.Y.Z, or Actions → Publish to MCP Registry.

solana-mcp-vybe (vybenetwork/solana-mcp-vybe)

正在搜索数据库…

这是什么?一个开发者工具包,让 AI 助手通过 44 个 MCP 工具查询 Solana 的实时数据,包括钱包、交易、市场、转账以及可签名的兑换交易。
它是我要安装的服务器,还是托管服务?它是一个托管的 MCP 服务器,所以你只需连接它,无需安装。本仓库只包含目录列表、Claude 插件和注册表元数据,正在运行的服务器位于另一个仓库中。
我该如何将它连接到客户端?将你的客户端指向 .mcp.json 中的 streamable HTTP 端点(Cursor、Windsurf、Codex),或将其添加为 Claude.ai 自定义连接器。然后在出现提示时批准 OAuth 登录。
我需要 Vybe 账户或 API 密钥吗?需要。使用你的 Vybe 邮箱作为用户名、Vybe API 密钥作为密码登录,然后批准授权。密钥永远不应提交到仓库中。
它能替我转移资金或签署交易吗?不能。兑换、关闭账户和提现的构建工具会返回未签名的交易,你需要在自己的钱包中签名。服务器既不接收私钥,也不广播交易。
它支持哪些 AI 客户端?通过 mcp-remote 使用的 Claude Desktop、Claude.ai 自定义连接器、Claude Code 和 Cowork 插件、Cursor、Windsurf、Codex 以及 ChatGPT Developer Mode。
钱包工具能告诉我某个地址的哪些信息?它们会返回代币余额和历史记录、PnL 及 PnL 历史、DeFi 持仓、空账户和灰尘账户、转账总量及交易对手,以及同时批量查询多个地址的功能。
它能给我兑换报价和兑换交易吗?可以。get-swap-quote 返回报价,build-swap 返回未签名的兑换交易,你需要在自己的钱包中签名并自行发送。
x402 指南涵盖哪些内容?get-x402-access-guide 讲解如何通过 x402 按次付费。它只提供静态指导,不会发送任何付款。
每个工具是否都对应一次 Vybe API 调用?是的。每个工具都调用 /v4 下的一个 Vybe API 端点,例如 get-token-top-holders 或 list-trades,因此结果与该 API 保持一致。
大小
0.4 MB
星标
2.8K
更新
提交Oct 27
时长
7个月
提交 · 90 天