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

📚 ドキュメント

• Starknet.js ドキュメント
• モデルコンテキストプロトコルドキュメント

🔧 技術詳細

ディレクトリ構造

src/
├── chains/                 # ブロックチェーンの設定ファイル
├── resources/             # 利用可能なリソースの定義
├── tools/                 # 提供されるツールセット
└── server.ts              # サーバーのメインプログラム

開発規約

• ツールを識別するために name を使用します。
• 環境変数を設定します。

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

📄 ライセンス

MIT License

⚠️ 重要提示

秘密鍵はトランザクションの署名にのみ使用され、サーバーには保存されません。

💡 使用建议

すべての入力は厳密に検証する必要があります。また、HTTPSを使用してネットワーク通信を保護してください。