mcp-installer

MCP インストーラー

OpenCode 用の MCP サーバーを検索、インストール、設定します。

1. MCP サーバーを検索する

まずローカルカタログを確認します（すでに記録されている MCP をすばやく確認します）。

python3 ~/.config/opencode/skill/mcp-installer/scripts/list_mcps.py

ローカルで見つからない場合は、オンラインで検索します。

• websearch("MCP server for [capability]")
• webfetch("https://github.com/modelcontextprotocol/servers")
• npm を確認します：@modelcontextprotocol/server-*
• MCP 仕様のリポジトリを確認します：https://github.com/modelcontextprotocol

2. MCP の詳細を読む

該当するものが見つかったら、MCP ファイル全体を読みます。

references/mcps/<name>.md

インストール設定、セットアップ、機能、リンクが記載されています。

3. 設定する

MCP の設定をユーザーの opencode.json に追加します。

4. 新しい MCP を記録する

オンラインで新しい MCP サーバーを見つけた場合は、今後の参照用に、以下のテンプレートを使用して references/mcps/<name>.md に必ず記録してください。

5. セットアップする（必要な場合）

• OAuth：opencode mcp auth <server-name> を実行します
• API キー：環境変数を設定します
• その他：MCP 固有のセットアップ手順に従います

<question_tool>

まとめて質問する： 関連する質問が 2 つ以上ある場合は、question ツールを使用します。質問が 1 つの場合は、通常のテキストで尋ねます。

構文： header は 12 文字以内、label は 1～5 語にします。デフォルトの選択肢には「(Recommended)」を追加します。

質問するタイミング：要件に合う MCP が複数ある場合、またはセットアップに OAuth/API キーが必要な場合です。

</question_tool>

ローカル MCP

{
  "mcp": {
    "name": {
      "type": "local",
      "command": ["npx", "-y", "@package/name"]
    }
  }
}

リモート MCP

{
  "mcp": {
    "name": {
      "type": "remote",
      "url": "https://example.com/mcp"
    }
  }
}

MCP ツールの管理

MCP はツールを公開します。ツール名（通常は MCP 名）を使用して、permission セクションから制御します。

グローバル／エージェントの権限：

{
  "permission": {
    "my-mcp": "deny",          // Disable all tools for this MCP
    "my-mcp*": "deny"          // Wildcard support
  }
}

パターンベースの制御：

{
  "permission": {
    "my-mcp": {
      "safe_tool": "allow",
      "risky_tool": "ask",
      "*": "deny"
    }
  }
}

レガシー設定

エージェントが、古い設定フィールド（例：tools:）を使用するレガシープロジェクトを扱う場合があります。そのような設定を見つけた場合は、必ず最新の permission: システムに修正してください。

OAuth

OAuth を使用するリモート MCP は、自動認証されます。

opencode mcp auth <server-name>

ステータスを確認します：opencode mcp list

<reference_files>

必要な情報	読むファイル
すべての設定オプション（ローカル、リモート、OAuth、環境変数）	references/configuration.md
一般的な MCP サーバーの例	references/examples.md
トラブルシューティング	references/troubleshooting.md

注： ローカルカタログ（list_mcps.py）は、見つかった MCP のキャッシュであり、完全な一覧ではありません。ローカルで該当するものが見つからない場合は、常にオンラインで検索することを推奨します。

</reference_files>

<documenting_new_mcps>

新しい MCP サーバーを見つけた場合は、必ず記録してください。

場所： references/mcps/<name>.md

テンプレート：

---
name: mcp-name
url: https://github.com/org/repo
type: local|remote
auth: oauth|api-key|none
description: One-line description
tags: [tag1, tag2]
---
# Display Name

Brief description.

## Installation

\`\`\`jsonc
{
  "mcp": {
    "name": {
      "type": "remote",
      "url": "https://example.com/mcp"
    }
  }
}
\`\`\`

## Setup

Steps for auth, env vars, etc.

## Features

- Feature 1
- Feature 2

## Links

- [GitHub](url)

その後、python3 scripts/list_mcps.py を実行して確認します。

Frontmatter のフィールド

フィールド	必須	用途
name	はい	MCP 識別子（設定内のキー）
url	いいえ	ソース URL
type	はい	local または remote
auth	はい	oauth、api-key、または none
description	はい	カタログ用の簡潔な説明
tags	いいえ	カテゴリータグの配列

</documenting_new_mcps>