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