代币交易协议服务器

FourTrader MCP Server是一个用于在BNB智能链上交易Four.meme代币的模型上下文协议服务器,支持AI助手通过标准化协议与Four.meme交互。

  • by sunneeee
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 sunneeee/fourtrader-mcp

使用说明

FourTrader MCP服务器-BNB链(4.meme)

MCP(模型上下文协议)服务器,用于在BNB智能链上交易Four.mem代币。使AI助手能够通过标准化协议与Four.meme进行交互。

🌟 特性

  • Four.mem交易:在Four.mem平台上买卖代币
  • 实时数据:通过Bitquery API访问价格、交易和绑定曲线
  • 钱包管理:检查BNB和代币余额
  • 克劳德集成:直接与Claude一起用于桌面

📋 先决条件

  • Node.js(v18+)
  • TypeScript
  • 带私钥的BNB钱包
  • Bitquery API密钥(用于令牌数据)
  • 桌面版Claude(可选,用于集成)

🚀 安装

1.克隆/创建项目

```bash mkdir fourtrader mcp cd fourtrader mcp ```

2.创建结构

``` fourtrader mcp/ ├── src/ │ ├── server.ts │ ├── 供应商/ │ │ ├── fourMeme.ts │ │ └── bitqueryApi.ts │ └── utils/ │ ├── config.ts │ └── logger.ts ├── .env ├── package.json 姓名: └── mcp-startup.js ```

3.安装依赖项

```bash npm 安装 ```

4.配置环境

将`.env.example.`复制到`.env`并填写:

```env

服务器配置

服务器名称=fourtrader mcp 服务器版本=1.0.0

BNB链配置

钱包地址=0x您的钱包地址 WALLET_PRIVATE_KEY=您的私人钥匙 BNB_RPC端点=https://bsc-dataseed.binance.org/

Four.mem配置

地址:0x5c952063c7fc8610FFDB798152D69F0B9550762b

Bitquery API配置

BITQUERY_API_KEY=您的比特查询_KEY_here 沥青_API_ENDPOINT=https://streaming.bitquery.io/graphql ```

⚠️ 重要:

  • 从以下位置获取Bitquery API密钥:https://bitquery.io/
  • 永远不要分享你的私钥!

5.建设项目

```bash npm运行构建 ```

6.启动服务器

```bash npm 启动 ```

🔧 Claude桌面配置

要将服务器与Claude for Desktop一起使用,请执行以下操作:

1.查找配置文件

  • macOS:`~/库/应用支持/Claude/Claude_desktop_config json`
  • 视窗:`%APPDATA%\Claude\Claude_desktop_config.json`

2.添加服务器

```json { “mcpServers”:{ “fourtrader”:{ “command”:“node”, “args”:[ “/full/path/to/fourtrader mcp/mcp startup.js” ], “cwd”:“/full/path/to/fourtrader mcp” } } } ```

将“/full/path/to/”替换为您的实际路径!

示例路径:

  • macOS:`/用户/用户名/桌面/fourtrader mcp`
  • Windows:`C:\\用户\\用户名\\桌面\\fourtrader mcp`

3.重新启动克劳德桌面

完全关闭并重新打开Claude Desktop。

4.验证连接

打开克劳德桌面→ 点击设置图标(左下角)→ 您应该在连接的服务器列表中看到“fourtrader”。

🛠️ 可用工具

工具 说明 参数
`get_token_info` 获取详细的令牌信息 `address`(字符串)
`get_token_price` 获取当前代币价格 `address`(字符串)
`get_recent_tokens` 获取Four.meme上的最新令牌 `limit`(数字,可选)
`get_bonding_curve_progress ` 获取绑定曲线进度 `address`(字符串)
`get_latest_trades` 获取代币的最新交易 `address`(字符串),`limit`(数字)
“buy_token” 购买代币 “地址”、“bnbAmount”、“滑点”、“gas Limit”
“sell_token” 出售代币 “地址”、“tokenAmount”、“滑点”、“gas Limit”
`get_bnb_balance` 获取钱包bnb余额 无
`get_token_balance` 获取特定令牌的余额 `address`(字符串)

💬 Claude使用示例

连接后,您可以问Claude:

  • “给我看看Four上最近的代币。meme”
  • “令牌0x的价格是多少…”
  • “购买0.1 BNB的此代币:0x…”
  • “我的BNB余额是多少?”
  • “显示令牌0x的绑定曲线进度…”

🧪 MCP检验员测试

在与Claude一起使用之前测试服务器:

```bash npx@modelcontextprotocol/检查器节点构建/server.js ```

打开http://127.0.0.1:6274在浏览器中测试工具。

📚 比特查询API

该项目使用Bitquery访问Four.meme链上数据:

  • 文档: https://docs.bitquery.io/docs/blockchain/BSC/four-meme-api/
  • 仪表盘: https://bitquery.io/
  • GraphQL游乐场: https://graphql.bitquery.io/

支持的查询

  • 令牌元数据
  • 实时价格
  • 交易历史
  • 粘结曲线进度
  • 流动性事件
  • 新创建的令牌

🔐 安全

⚠️ 警告:

  1. 私钥:永远不要分享或提交到Git
  2. API密钥:确保API密钥的安全
  3. 测试网:始终先在测试网上进行测试(BSC测试网)
  4. 金额:从少量测试开始
  5. .env:将.env添加到.gitignore`

```bash echo“.env”>>.gitignore ```

🐛 故障排除

服务器未连接到Claude

  1. 验证`claude_desktop_config.json `中的路径是否正确
  2. 检查日志:
    • macOS:`~/Library/Logs/Claude/mcp*.log`
    • Windows:`%APPDATA%\Claude\logs\mcp*.log`
  3. 完全重新启动克劳德桌面

“Bitquery API”错误

  • 验证您的API密钥是否有效
  • 检查速率限制:https://bitquery.io/pricing
  • 某些数据可能并非适用于所有令牌

“资金不足”错误

  • 确保你的钱包里有足够的BNB
  • 考虑天然气费用(每笔交易约0.001-0.005 BNB)

交易失败

  • 增加参数中的“gasLimit”
  • 检查令牌是否存在并且可以交易
  • 验证“滑点”(对于易失性代币,尝试增加到5-10%)

📝 重要说明

  1. Four.meme没有公共REST API:我们使用Bitquery访问链上数据
  2. 智能合约:四个模因地址:0x5c952063c7fc8610FFDB798152D69F0B9550762b`
  3. BNB链:始终使用BNB智能链(BSC),而不是BNB信标链
  4. 天然气费:交易成本为BNB(通常为0.001-0.005 BNB)

🔄 与Solana项目的差异

Aspect Solana(PumpFun) BNB(四个米姆)
区块链 Solana BNB智能链
库 @solana/web3.js ethers.js
数据API Moralis Bitquery
原生代币 SOL BNB
天然气费用 ~0.00001索尔 ~0.001-0.005文莱元

🤝 支持

  • Bitquery文档: https://docs.bitquery.io/
  • Four.mem: https://four.meme/
  • BNB链: https://docs.bnbchain.org/
  • MCP协议: https://modelcontextprotocol.io/

📄 许可证

麻省理工学院

⚠️ 免责声明

该软件按“原样”提供。加密货币交易涉及风险。使用风险自负。