Cairo Coder MCP

🚀 Cairo Coder MCP Server

CairoとStarknetの開発支援を行うためのModel Context Protocol (MCP)サーバーで、Cairo Coder APIを介して動作します。

🚀 クイックスタート

このMCPサーバーは、npxを使って直接利用できます。

npx -y @kasarlabs/cairo-coder-mcp

✨ 主な機能

• Cairoコードの作成：スマートコントラクトやCairoコードを生成します。
• コードのリファクタリング：既存のコードを改善し最適化します。
• 機能の実装：TODOを完了し、特定の機能を実装します。
• Starknetの学習：Starknetエコシステムに関するコンテキスト情報を取得します。
• ベストプラクティス：Cairo/Starknetのドキュメントに基づいたアドバイスを受け取ります。

📦 インストール

前提条件

• Node.js >= 18
• npmまたはyarn

ローカルインストール

git clone <repository-url>
cd cairo-coder-mcp
npm install

💻 使用例

assist_with_cairo

CairoとStarknetの開発タスクに関するヘルプを得ます。

パラメーター

• query (文字列、必須): Cairo/Starknetの開発に関する質問
• context (文字列、オプション): 追加のコンテキストまたはコードスニペット

基本的な使用法

// シンプルなリクエスト
{
  "query": "Write a simple Cairo contract that implements a counter"
}

高度な使用法

// コンテキスト付き
{
  "query": "How can I optimize this contract?",
  "context": "#[starknet::contract]\nmod Counter {\n    // existing code here\n}"
}

📚 ドキュメント

設定

このサーバーは2つの動作モードをサポートしています。

モード1: 公開Cairo Coder API (デフォルト)

公式のCairo Coder APIをAPIキーを使って利用します。

環境変数

• CAIRO_CODER_API_KEY: あなたのCairo Coder APIキー (必須)

MCPクライアントの設定

{
  "mcpServers": {
    "cairo-coder": {
      "command": "npx",
      "args": ["-y", "@kasarlabs/cairo-coder-mcp"],
      "env": {
        "CAIRO_CODER_API_KEY": "your-api-key-here"
      }
    }
  }
}

モード2: ローカル/カスタムエンドポイント

ローカルまたはカスタムのCairo Coder APIエンドポイントを利用します (APIキーは不要)。

環境変数

• CAIRO_CODER_API_ENDPOINT: あなたのローカルエンドポイントのURL (例: "http://localhost:8000")

MCPクライアントの設定

{
  "mcpServers": {
    "cairo-coder": {
      "command": "npx",
      "args": ["-y", "@kasarlabs/cairo-coder-mcp"],
      "env": {
        "CAIRO_CODER_API_ENDPOINT": "http://localhost:8000"
      }
    }
  }
}

⚠️ 重要提示

CAIRO_CODER_API_ENDPOINTを使用する場合、サーバーは自動的にローカルモードに切り替わり、APIキーは必要なく、使用されません。

開発

利用可能なスクリプト

npm run build    # プロジェクトをビルドします
npm run dev      # 開発モードで起動します
npm start        # 本番モードで起動します

ベターな結果を得るためのヒント

• 具体的なクエリを使用してください (例: "ERC20"ではなく、"Using OpenZeppelin to build an ERC20")
• 既存のコードを扱う際には、関連するコードスニペットを含めてください
• より正確な応答を得るために、必要なコンテキストを提供してください

📄 ライセンス

MIT

サポート

問題や質問については以下の場所をご利用ください。

• GitHub Issues: Create an issue
• MCPドキュメント: Model Context Protocol

コントリビューション

コントリビューションは大歓迎です！PRを提出する前に、コントリビューションガイドラインを確認してください。