ドキュメント

MCP Fusion/Get started/インストール

インストール

VinkiusについてAIに質問

@mcpfusion/core をインストールし、CLI で最初のサーバーをスキャフォールディングし、認証、テスト、デプロイ用のアドオンパッケージを確認します。

MCP Fusion は、オプションのアドオン一式とともに npm パッケージ @mcpfusion/core として提供されます。動作には Node.js 18 以降と TypeScript 5.7 以降が必要です。

コアをインストールする

bash
npm install @mcpfusion/core @modelcontextprotocol/sdk

公式の @modelcontextprotocol/sdk はピア依存関係です。MCP Fusion はその上に MCP 2.0 プロトコルを実装しており、完全な互換性を保っています。

サーバーをスキャフォールディングする

bash
npx @mcpfusion/core create my-server

スキャフォールディングはいくつかの質問をして、動くプロジェクトを生成します。

  • initMCPFusion() がすぐ実行できる状態の src/server.ts
  • ファイルベースルーティングがツールを探索する src/tools/
  • 転送とポートを指定する startServer() を置く src/server.ts
  • AI コーディングエージェントが自動的に従う SKILL.md のアーキテクチャ契約

Cursor、Claude Code、Copilot、Windsurf などの AI コーディングエージェントを使っていますか?CLI が SKILL.md の契約を .cursorrules、.windsurfrules、.clinerules に自動注入します。エージェントは指示しなくても MVA スタイルのコードを書きます。詳しくは Skills を参照してください。

ローカルで実行する

bash
mcpfusion dev --server ./src/server.ts

mcpfusion dev はホットリロード付きでサーバーを起動します。すぐに試せるようクライアントを接続しましょう。

bash
claude mcp add my-server npx tsx src/server.ts

アドオンパッケージ

各アドオンは @mcpfusion スコープの独立した npm パッケージです。必要なものだけをインストールしてください。

パッケージ追加される機能
@mcpfusion/yamlYAML で書くコードゼロのツール
@mcpfusion/jwtHS256、RS256、JWKS による JWT 検証
@mcpfusion/oauthOAuth 2.0 Device Authorization Grant
@mcpfusion/api-keyタイミング攻撃に強い API キー検証
@mcpfusion/skillsSKILL.md のプログレッシブ開示
@mcpfusion/testingパイプライン全体のインメモリテストハーネス
@mcpfusion/vercel同じサーバーを Vercel にデプロイ
@mcpfusion/cloudflare同じサーバーを Cloudflare Workers にデプロイ
@mcpfusion/awsLambda 関数と Step Functions をツール化
@mcpfusion/openapi-genOpenAPI 仕様から Models、Views、Agents を生成
@mcpfusion/prisma-genPrisma スキーマからツールと Presenter を生成
bash
npm install @mcpfusion/jwt

サーバーのオプション

個別の設定ファイルはありません。サーバーのエントリーポイントは startServer() を素のオプションオブジェクトとともに呼びます。transport は stdio(既定)、http(セッション付き Streamable HTTP。ポート、TTL、レート制限、CORS のオプションあり)、または stateless(MCP 2.0:リクエストごとに新しいサーバー、ハンドシェイクなし、どのロードバランサーでも任意のリクエストを処理)です。

次のステップ

  • Quickstart: 最初のツールを作って接続する
  • Deploy: コネクターを無料で Vinkius Cloud に載せる
  • CLI: mcpfusion の全コマンド解説