Shanone MCP Server (Node.js)

CursorやClaudeなどのMCPクライアントからShanoneにタスクを投げて実行させるためのMCPサーバー。

インストール

npx @duzzle/shanone-mcp

または、グローバルインストール:

npm install -g @duzzle/shanone-mcp

設定

Cursor設定

~/.cursor/mcp.json に以下を追加:

{
  "mcpServers": {
    "shanone": {
      "command": "npx",
      "args": ["-y", "@duzzle/shanone-mcp"],
      "env": {
        "SHANONE_API_KEY": "shanone_sk_xxx",
        "SHANONE_API_URL": "https://shanone.ai/api"
      }
    }
  }
}

環境変数

| 変数名 | 必須 | 説明 | |--------|------|------| | SHANONE_API_KEY | ✅ | Shanone APIキー（Settings > API Keys で取得） | | SHANONE_API_URL | - | Shanone API URL（デフォルト: https://shanone.ai/api） |

利用可能なツール

Node版はTool Vendor(サービス統合)とSkill Vendor機能のみをサポートしています。複数ステップ・複数サービスにわたるオーケストレーション実行(shanone_run_task)が必要な場合はPython版(apps/mcp-server/)を使用してください。

shanone_health_check

Shanone MCPサーバーの接続状態・認証状態・バックエンドの健全性を確認します。APIキーの有効性とDB接続性のPASS/FAILテーブルを含む、ボックス描画のターミナル風画面を返します。

Tool Vendor(個別サービス統合の呼び出し)

shanone_search_tools

ツールをキーワードで検索します(関連度順)。

パラメータ:

• query (必須): 検索キーワード
• service (オプション): サービスフィルター（例: 'slack', 'github'）
• limit (オプション): 最大結果数（デフォルト: 20）
• offset (オプション): ページネーション用オフセット

shanone_list_service_tools

特定サービスの全ツールを一覧表示します(名前順・全件)。「Slackで使えるツール一覧は？」のような網羅的な問い合わせにはshanone_search_toolsより本ツールを使用。

パラメータ:

• service (必須): サービス名（例: 'slack', 'github', 'notion'）
• limit (オプション): 1ページの最大結果数（デフォルト: 50）
• offset (オプション): ページネーション用オフセット

shanone_get_tool_schema

特定のツールの入力スキーマを取得します。

パラメータ:

• tool_name (必須): ツール名

shanone_execute_tool

ツールを実行します。OAuth未接続の場合はconnect_linkを返します。

パラメータ:

• tool_name (必須): 実行するツール名
• arguments (必須): ツールの引数
• session_id (オプション): セッションID

Skill Vendor(再利用可能なワークフロー)

shanone_list_skills

保存済みSkillを一覧表示します。

パラメータ:

• query (オプション): 名前/概要に対するフィルター
• limit (オプション): 1ページの最大結果数（デフォルト: 20）
• offset (オプション): ページネーション用オフセット

shanone_get_skill

指定したSkillの完全な指示内容を取得します。

パラメータ:

• skill_id (必須): Skill ID

shanone_create_skill

新しいSkillを作成します。

パラメータ:

• name (必須): Skill名
• description (必須): Skillの説明
• body (必須): 手順・指示内容

shanone_update_skill

既存のSkillを更新します(空欄のフィールドは変更されません)。

パラメータ:

• skill_id (必須): Skill ID
• name, summary, instructions (いずれもオプション)

shanone_delete_skill

Skillを削除します。

パラメータ:

• skill_id (必須): Skill ID

Permission Vendor(権限管理、Root / SA2委任ユーザーのみ)

shanone_list_services

プラットフォームに登録されている全サービス(連携先)の一覧を取得します(Root権限不要)。

shanone_list_user_tool_permissions

対象ユーザーのサービス/ツール単位の権限オーバーライドを一覧表示します。Rootユーザーのみ。

パラメータ:

• target_user_id (必須): 確認対象のuser_id

shanone_set_user_tool_permission

対象ユーザーの特定ツール1つの実行可否を切り替えます。Rootユーザーのみ。

パラメータ:

• target_user_id (必須): 変更対象のuser_id
• tool_name (必須): ツール名
• enabled (必須): true/false

shanone_set_user_service_permission

対象ユーザーの特定サービスに属する全ツールの実行可否を一括で切り替えます。Rootユーザーのみ。

パラメータ:

• target_user_id (必須): 変更対象のuser_id
• service_name (必須): サービス名
• enabled (必須): true/false

shanone_get_permission_summary

対象ユーザーの権限状況の集計サマリーを取得します。Rootユーザーのみ。

パラメータ:

• target_user_id (必須): 確認対象のuser_id

shanone_batch_set_user_permissions

複数のサービス/ツールの実行可否を1回のリクエストでまとめて切り替えます。Rootユーザーのみ。

パラメータ:

• target_user_id (必須): 変更対象のuser_id
• operations (必須): {type: "service"|"tool", name: string, enabled: boolean} の配列(最大500件)

開発

# 依存関係をインストール
npm install

# ビルド
npm run build

# 開発モードで実行
npm run dev

ライセンス

MIT