starknet-mcp-server

🚀 Starknet 模型上下文协议服务器

本项目是 Model Context Protocol 在 Starknet 上的实现。该服务器能让 AI 助手与 Starknet 区块链进行交互，支持查看余额、解析地址、查询交易等多种操作，为区块链应用开发提供便利。

🚀 快速开始

import { createServer } from 'starknet-mcp-server'

async function main() {
  const server = await createServer()
  await server.start(3000)
  console.log('服务器已启动，访问 http://localhost:3000')
}

main().catch(console.error)

✨ 主要特性

支持的区块链协议

• Starknet 主网
• Starknet 测试网

资源架构

{
  chains: {
    // 区块链配置信息
    resources: {
      // 可用资源列表
      tools: {
        // 提供的工具集
      }
    }
  }
}

工具集

示例工具：查询地址余额

server.tool({
  name: 'starknet_balance',
  description: '查询 Starknet 地址的 ETH 和代币余额',
  params: {
    address: string().describe('目标地址')
  },
  async run({ address }) {
    return await balance getAddress(address)
  }
})

📦 安装指南

npm install starknet-mcp-server

配置

在 ~/.config/starknet-mcp-server/config.json 中添加以下配置：

{
  "chains": {
    "starknet-mainnet": {
      "url": "https://alpha-mainnet.starknet.io",
      "contract_address": "0x starknet-mainnet 合约地址"
    },
    "starknet-testnet": {
      "url": "https://alpha-testnet.starknet.io",
      "contract_address": "0x starknet-testnet 合约地址"
    }
  }
}

💻 使用示例

基础用法

• 查询地址余额：balance of 0x04d07e40e93398ed3c76981e449d3446f7c4e52aac5b3e8a37d7b0ca30845a5d
• 解析地址到 Starknet ID：lookup starknet_id for 0x04d07e40e93398ed3c76981e449d3446f7c4e52aac5b3e8a37d7b0ca30845a5d
• 查询最新区块：latest block on starknet mainnet

📚 详细文档

项目架构

目录结构

src/
├── chains/                 # 区块链配置文件
├── resources/             # 可用资源定义
├── tools/                 # 提供的工具集
└── server.ts              # 服务器主程序

开发规范

• 使用 name 标识工具
• 配置环境变量：

  CHAINS=starknet-mainnet,starknet-testnet
  CONTRACT_ADDRESS=0x mainnet_address,0x testnet_address
  

文档资源

• Starknet.js 文档
• 模型上下文协议文档

⚠️ 重要提示

• 私钥仅用于签名交易，不会被服务器存储
• 所有输入都需要经过严格验证
• 使用 HTTPS 保护网络通信

📄 许可证

MIT License