VoltAgent : MCP Docs サーバ

by

VoltAgent MCP (Model Context Protocol) Docs サーバは AI アシスタントが VoltAgent のドキュメント, サンプル, そして変更ログに直接アクセスすることを可能にします。これは、AI アシスタントが最新のドキュメントを使用して VoltAgent 関連の質問に答えることを可能にします。

VoltAgent : Get Started : MCP Docs サーバ

作成 : クラスキャット・セールスインフォメーション
作成日時 : 12/20/2025
バージョン : @voltagent/core@1.4.0

* 本記事は voltagent.dev/docs の以下のページを独自に翻訳した上で、補足説明を加えてまとめ直しています。スニペットはできる限り日本語を使用しています :

* サンプルコードの動作確認はしておりますが、必要な場合には適宜、追加改変しています。
* ご自由にリンクを張って頂いてかまいませんが、sales-info@classcat.com までご一報いただけると嬉しいです。

 

 

VoltAgent : MCP Docs サーバ

VoltAgent MCP (Model Context Protocol) Docs サーバは AI アシスタントが VoltAgent のドキュメント, サンプル, そして変更ログに直接アクセスすることを可能にします。これは、AI アシスタントが最新のドキュメントを使用して VoltAgent 関連の質問に答えることを可能にします。

 

What Does It Do?

MCP Docs サーバを使用して、AI アシスタントは以下を行うことが可能になります :

  • 📚 VoltAgent ドキュメントの検索 – 任意のトピックについて詳細な説明を見つけられます

  • 🔍 コードサンプルのブラウズ – 実際のプロジェクトから動作するコードサンプルを示すことができます。

  • 📋 変更ログのブラウズ – バグ修正や新機能について情報を提供できます。

 

自動インストール

💡 create-voltagent-app@latest を使用して新しいプロジェクトを作成する場合、どの IDE (Cursor, Windsurf, or VS Code) を使用しているか尋ねられます。MCP Docs サーバは自動的にインストールされて選択した IDE 向けに構成設定されます。追加のステップは必要ありません。

npm create voltagent-app@latest
# ✔ What is your project named? › my-app
# ✔ Which package manager do you want to use? › npm
# ✔ Which IDE are you using? (For MCP Docs Server configuration) › Cursor
# ✔ MCP Docs Server configured for Cursor!
#   Configuration file created in .cursor/mcp.json

 

手動セットアップ (上級)

ℹ️ 手動セットアップはいつ必要か？
create-voltagent-app@latest を使用して作成されていない既存のプロジェクトに MCP Docs サーバを追加する場合にのみ、手動セットアップが必要となります。

 

CLI によるクイックセットアップ

既存の VoltAgent プロジェクトに対して、専用の CLI コマンドを使用できます :

volt mcp setup

この対話的コマンドは :

  • 適切な設定ファイルを作成します

  • セットアッププロセスをガイドします

 

手動設定

手動設定したい場合は、IDE を直接設定します :

Cursor

  1. Cursor settings を開く: Cmd/Ctrl +

  2. “Features” > “Model Context Protocol” に移動

  3. 新しい MCP サーバの追加 :

    {
  "name": "voltagent",
  "command": "npx",
  "args": ["-y", "@voltagent/docs-mcp"]
}

    ローカルビルドを使用するには:

    {
  "name": "voltagent",
  "command": "node",
  "args": ["path/to/voltagent/packages/docs-mcp/dist/server.js"]
}

  4. settings を保存して Cursor を再起動します

 

セットアップのテスト

create-voltagent-app@latest でプロジェクトを作成した後 (または手動セットアップ完了後)、IDE を再起動して、AI アシスタントに以下のような質問をして MCP 接続をテストします :

  • How do I create an agent in VoltAgent?

  • Do you have a Next.js example with VoltAgent?

  • How do I use the voice features?

 

CLI コマンド

VoltAgent CLI は MCP セットアップを管理するためのいくつかのコマンドを提供しています :

 
volt mcp setup

IDE 用に MCP を構成設定する、対話型セットアップコマンド :

volt mcp setup        # Interactive setup
volt mcp setup --force # Force overwrite existing configuration

 
volt mcp status

現在の MCP 構成設定ステータスを確認します :

volt mcp status

 
volt mcp test

テストの提案とトラブルシューティングのヒントを取得します :

volt mcp test

 
volt mcp remove

MCP 構成設定を削除します :

volt mcp remove

 

利用可能なツール

MCP Docs サーバはこれらのツールを提供します :

📚 ドキュメント・ツール

  • search_voltagent_docs: ドキュメントを検索
  • get_voltagent_doc: 特定のドキュメント・ファイルの取得
  • list_voltagent_docs: ドキュメント構造のリスティング

 
🔍 サンプル・ツール

  • search_voltagent_examples: サンプルを検索
  • get_voltagent_example: 特定のサンプルコンテンツの取得
  • list_voltagent_examples: 利用可能なサンプルのリスティング

 
📋 変更ログ・ツール

  • list_voltagent_changelogs: パッケージ変更ログのリスティング
  • get_voltagent_changelog: 特定のパッケージの変更ログの取得
  • search_voltagent_changelogs: 変更ログにわたる検索

 

以上