Stacks Clarity MCP

🚀 Stacks Clarity MCP Server (非公式)

Stacksブロックチェーン開発用の包括的なMCP（Model Context Protocol）サーバーです。Clarityスマートコントラクト、SIP準拠、セキュリティ、およびパフォーマンス最適化のための30以上の専用ツールを提供します。

提供:

💡 MCPが初めての方へ

統合ガイドを参照して、Cursor、Claude Code、またはローカル開発の手順を1つずつ確認してください。

🚀 クイックスタート

この包括的なMCPサーバーは、完全なStacks開発ツールキットを提供します。セキュリティを最優先とするパターンとSIP準拠で、プロのStacks dApp開発のTIER 1およびTIER 2の優先事項を実装しています。

主な機能

• 🏗️ 完全なSIP標準アクセス - すべての30以上のSIP標準と完全なClarityコード
• 🔐 セキュリティを重視した開発 - すべてのトークン転送に必須の事後条件
• ⚡ SIP-012パフォーマンス最適化 - データベース容量が2倍、動的ストレージ
• 🎨 トークン標準 - 完全なSIP-009（NFT）およびSIP-010（FT）の実装
• 🧪 包括的なテスト - 単体、統合、およびセキュリティテストの生成
• 🔧 Clarinet統合 - 完全なプロジェクトセットアップと管理ツール
• 💰 アカウント管理 - STX残高、トランザクション履歴、および検証
• 📚 完全なドキュメント - Clarityブック、SIP標準、および統合ガイド

📋 前提条件

• Node.jsとnpm (npm ≥ 5.2.0)
• Clarinet CLI (コントラクト開発用)
• Stacksウォレット (フロントエンド統合用)
• Cursor IDEまたはClaude Code (MCP統合用)

🛠️ Cursor/Claude Codeのクイックセットアップ

オプション1: 公開されたパッケージを使用する（利用可能な場合）

npmに公開されたら、プロジェクト内に .cursor/mcp.json を作成します。

{
  "mcpServers": {
    "stacks-clarity-mcp": {
      "command": "npx",
      "args": ["-y", "@stacks/stacks-clarity-mcp"],
      "env": {
        "HIRO_API_KEY": "",
        "STACKS_NETWORK": "testnet"
      }
    }
  }
}

オプション2: ローカル開発セットアップ（現在）

1. クローンしてインストールする

git clone https://github.com/YOUR_USERNAME/stacks-clarity-mcp.git
cd stacks-clarity-mcp
npm install

2. プロジェクトをビルドする

npm run build

注意: これにより、コンパイルされたJavaScriptが含まれる dist/ フォルダが生成されます。サーバーを実行する前にビルドが必要です。

3. Cursorを設定する - プロジェクトルートに .cursor/mcp.json を作成します。

{
  "mcpServers": {
    "stacks-clarity-mcp": {
      "command": "npx",
      "args": ["-y", "tsx", "/absolute/path/to/stacks-clarity-mcp/src/server.ts"],
      "env": {
        "HIRO_API_KEY": "",
        "STACKS_NETWORK": "testnet"
      }
    }
  }
}

重要: /absolute/path/to/stacks-clarity-mcp を実際のパスに置き換えてください！

4. Cursorを完全に再起動する（ウィンドウを閉じるだけでなく）

5. セットアップを確認する

   • Cursor → Settings → MCP に移動します。
   • stacks-clarity-mcp の横にある緑色のインジケーターを確認します。
   • チャットで Agent モードに切り替えます。
   • "list available stacks tools" でテストします。

ネットワークオプション

• mainnet - 本番用のStacksネットワーク
• testnet - 無料トークンを持つテストネットワーク
• devnet - Clarinetを使用したローカル開発

Hiro APIキーを取得する（オプション）

拡張機能とより高いレート制限を利用するには、次の手順を実行します。

1. platform.hiro.so にアクセスします。
2. アカウントを作成し、APIキーを生成します。
3. 設定の HIRO_API_KEY に追加します。

📚 詳細ガイド: Cursor、Claude Code、および開発のセットアップについては、 フォルダを参照してください。

📦 リポジトリに含まれるもの

含まれる（GitHubにプッシュされる）:

• ✅ src/ - TypeScriptソースコード (452KB)
• ✅ stacks-clarity-standards/ - すべての30以上のSIP標準 (9.2MB)
• ✅ integration_guides/ - セットアップドキュメント
• ✅ package.json, tsconfig.json - 設定ファイル

除外される（プッシュされない）:

• ❌ node_modules/ - 依存関係 (165MB) - npm install でインストールする
• ❌ dist/ - ビルド出力 (448KB) - npm run build で生成する
• ❌ .cursor/ - ローカルMCP設定
• ❌ .env - 環境変数

セットアップ要件: クローンした後、MCPサーバーを使用する前に npm install と npm run build を実行する必要があります。

📖 利用可能なツール（合計32個）

🔍 標準とドキュメント（5つのツール）

• list_sips - 利用可能なすべてのSIP標準を検索する
• get_sip - 特定のSIPコンテンツを取得する（SIP-009、SIP-010など）
• get_clarity_book - 完全なClarity言語リファレンス（34,000行以上）
• get_token_standards - 必須のSIP-009/SIP-010標準
• search_sips - トピックでSIPを検索する

🪙 トークン開発（8つのツール）

SIP-010ファンジブルトークン

• get_sip010_info - トークンコントラクト情報とメタデータ
• get_sip010_balance - アドレスのFT残高を確認する
• generate_sip010_transfer - 事後条件付きの転送トランザクションを作成する
• generate_sip010_template - 完全なSIP-010準拠のコントラクトを生成する

SIP-009非ファンジブルトークン

• get_sip009_token_info - NFT情報とメタデータ
• get_sip009_collection_info - コレクションレベルの情報
• generate_sip009_transfer - 事後条件付きのNFT転送を作成する
• generate_sip009_template - 完全なSIP-009準拠のコントラクトを生成する

🔐 セキュリティと事後条件（5つのツール）

• generate_fungible_post_condition - 必須のFT事後条件
• generate_nonfungible_post_condition - 必須のNFT事後条件
• generate_stx_post_condition - STX転送の事後条件
• analyze_transaction_post_conditions - トランザクションのセキュリティを検証する
• generate_post_condition_template - セキュリティテンプレートとパターン

⚡ パフォーマンス最適化 - SIP-012（3つのツール）

• analyze_contract_performance - 包括的なパフォーマンス分析
• estimate_operation_cost - Clarity操作のコスト推定
• generate_optimization_recommendations - SIP-012最適化戦略

👤 アカウント管理（4つのツール）

• get_stacks_account_info - 包括的なアカウント情報
• check_stx_balance - 簡単なSTXおよびトークン残高の確認
• get_transaction_history - ページネーション付きのアカウントトランザクション履歴
• validate_stacks_address - アドレス形式とネットワークの検証

🧪 開発とテスト（4つのツール）

• generate_clarinet_project - 完全なClarinetプロジェクトセットアップ
• generate_clarity_contract - SIP準拠のコントラクト生成
• generate_contract_tests - 単体、統合、およびセキュリティテスト
• configure_clarinet_project - ネットワークと環境の設定

🎨 フロントエンド開発（3つのツール）

• build_clarity_smart_contract - スマートコントラクト開発ガイダンス
• build_stacks_frontend - @stacks/connectを使用したフロントエンド統合
• build_stacks_dapp - 完全なフルスタック開発ガイド

🚀 クイックスタートガイド

1. 利用可能な標準を探索する

// すべてのSIP標準を検索する
use tool: list_sips

// 特定のトークン標準を取得する
use tool: get_token_standards

// 完全なClarityリファレンスにアクセスする
use tool: get_clarity_book

2. SIP-010トークンを構築する

// 準拠するトークンコントラクトを生成する
use tool: generate_sip010_template
params: {
  tokenName: "MyToken",
  symbol: "MTK",
  decimals: 6,
  features: ["minting", "burning"]
}

// 安全な転送を作成する
use tool: generate_sip010_transfer
params: {
  contractId: "ST1H1733V5MZ3SZ9XRW9FKYGEZT0JDGEB8Y634C7R.my-token",
  amount: 1000000,
  sender: "ST1H1733V5MZ3SZ9XRW9FKYGEZT0JDGEB8Y634C7R",
  recipient: "ST2CY5V39NHDPWSXMW9QDT3HC3GD6Q6XX4CFRK9AG",
  memo: "Secure transfer with post-conditions"
}

3. 開発環境をセットアップする

// Clarinetプロジェクトを初期化する
use tool: generate_clarinet_project
params: {
  projectName: "my-stacks-project",
  template: "fungible-token"
}

// 包括的なテストを生成する
use tool: generate_contract_tests
params: {
  contractName: "my-token",
  testType: "security",
  scenarios: ["post-conditions", "authorization"]
}

🔒 セキュリティ機能

必須の事後条件

すべてのトークン転送には、事後条件を含める 必要があります。MCPサーバーはこれを強制します。

// ✅ 正しい: 事後条件付きの転送
use tool: generate_fungible_post_condition
params: {
  address: "ST1H1733V5MZ3SZ9XRW9FKYGEZT0JDGEB8Y634C7R",
  contractId: "ST1H1733V5MZ3SZ9XRW9FKYGEZT0JDGEB8Y634C7R.token",
  amount: 1000000,
  condition: "equal"
}

// 最大限のセキュリティのために、常にPostConditionMode.Denyを使用する

SIP準拠の強制

• 自動的なSIP-009およびSIP-010準拠チェック
• ネイティブアセット関数の使用（ft-transfer?、nft-transfer?）
• 適切なエラーハンドリングと承認パターン

⚡ パフォーマンス最適化

SIP-012の利点

• 2倍のデータベース操作 - ブロックあたりの読み取り/書き込み制限が増加
• 動的リストストレージ - 実際のデータサイズに応じてのみ料金を支払う
• 最適化されたコスト関数 - 100以上の改善されたコスト計算

// コントラクトのパフォーマンスを分析する
use tool: analyze_contract_performance
params: {
  contractCode: "...", // あなたのClarityコントラクト
  optimizationLevel: "advanced"
}

// 最適化の推奨事項を取得する
use tool: generate_optimization_recommendations
params: {
  contractPattern: "token-contract",
  currentIssues: ["high gas costs", "multiple map operations"]
}

📚 包括的なドキュメント

完全なStacks開発リソースへのアクセスが可能です。

• 34,000行以上のClarityブックドキュメント
• 30以上のSIP標準と完全な実装
• セキュリティパターンとベストプラクティス
• パフォーマンス最適化ガイド
• フロントエンド統合の例

🏗️ 統合例

Reactフロントエンドと@stacks/connect

// 完全なフロントエンドガイダンスを取得する
use tool: build_stacks_frontend

// ウォレット接続コードを生成する
// 事後条件付きのトランザクション署名
// エラーハンドリングとユーザーエクスペリエンス

DeFiプロトコル開発

// パフォーマンス最適化されたDeFiコントラクト
use tool: generate_clarity_contract
params: {
  contractName: "amm-pool",
  contractType: "custom",
  features: ["governance", "staking"]
}

// セキュリティテスト
use tool: generate_contract_tests
params: {
  contractName: "amm-pool",
  testType: "security",
  scenarios: ["reentrancy", "authorization", "post-conditions"]
}

NFTマーケットプレイス

// SIP-009準拠のNFTコレクション
use tool: generate_sip009_template
params: {
  collectionName: "Art Collection",
  symbol: "ART",
  features: ["metadata", "royalties"]
}

// エスクロー付きのマーケットプレイスコントラクト
use tool: generate_clarity_contract
params: {
  contractName: "nft-marketplace",
  contractType: "custom",
  features: ["escrow", "royalties"]
}

🔧 開発ワークフロー

1. 標準を調査する - list_sips と get_sip を使用して要件を理解する
2. コントラクトを生成する - テンプレートツールを使用してSIP準拠の実装を作成する
3. セキュリティテストを行う - 包括的なセキュリティテストスイートを生成する
4. パフォーマンス最適化を行う - SIP-012ツールを使用して分析し、最適化する
5. フロントエンドを統合する - ウォレット接続機能を持つユーザーインターフェイスを構築する
6. デプロイする - Clarinetツールを使用して本番環境にデプロイする

📋 本番環境チェックリスト

• ✅ SIP準拠が検証されている
• ✅ 必須の事後条件が実装されている
• ✅ セキュリティテストが合格している
• ✅ SIP-012でパフォーマンスが最適化されている
• ✅ フロントエンドが適切に統合されている
• ✅ すべてのテスト（単体、統合、セキュリティ）が合格している

🐛 トラブルシューティング

MCPサーバーがCursorに表示されない場合

1. MCP設定を確認する

   • Cursor → Settings → Cursor Settings → MCP に移動します。
   • stacks-clarity-mcp のエントリを探します。
   • インジケーターが緑色（接続済み）または赤色（エラー）であることを確認します。
   • エントリをクリックしてエラー詳細を表示します。

2. 設定を検証する

   • プロジェクトルートに .cursor/mcp.json が存在することを確認します。
   • ローカル開発の場合は、server.ts への絶対パスを使用します。
   • Node.jsがインストールされていることを確認します: node --version

3. Cursorを再起動する

   • Cursorを完全に終了します（ウィンドウを閉じるだけでなく）。
   • Cursorを再開します。
   • MCPが初期化されるまで10-15秒待ちます。

4. エージェントモードを確認する

   • Cursorチャットで、ドロップダウンが エージェント（通常のチャットではない）に設定されていることを確認します。
   • MCPツールはエージェントモードでのみ機能します。

5. MCP接続をテストする

# サーバーを直接テストする
npx tsx /path/to/server.ts

# またはMCPインスペクターを使用する
npx @modelcontextprotocol/inspector

一般的な問題

"Command not found": npx tsx を使用していることを確認してください。tsx だけではなく。

"Module not found": MCPサーバーディレクトリで npm install を実行してください。

ビルドエラー: ローカル開発の場合は、ソースから実行するには tsx を使用します（ビルドステップをスキップします）。

ツールが表示されない: エージェントモードであり、MCPが緑色のインジケーターを表示していることを確認してください。

ヘルプを得る

• 統合ガイドを確認して詳細なセットアップを行ってください。
• development_usage.mdを確認してローカル開発を行ってください。
• MCPインスペクターを使用してツールをテストしてください: npx @modelcontextprotocol/inspector

🤝 コントリビューション

このMCPサーバーは、完全なStacks開発スタックを実装しています。コントリビューションは以下を維持する必要があります。

• セキュリティを最優先とする原則
• SIP標準の準拠
• パフォーマンス最適化の重視
• 包括的なドキュメント

📄 ライセンス

このプロジェクトは、Apache 2.0ライセンスの下でライセンスされています。

🔗 リソース

• Stacksドキュメント
• Clarity言語リファレンス
• SIP標準
• Clarinet CLI
• Stacks.js

セキュリティ、パフォーマンス、および準拠を最優先としたプロのStacks開発のために構築されています。