Skip to content

Instantly share code, notes, and snippets.

@mostlyfine
Created April 13, 2026 04:18
Show Gist options
  • Select an option

  • Save mostlyfine/b76625ad6ee55614ca3e38319986d2a1 to your computer and use it in GitHub Desktop.

Select an option

Save mostlyfine/b76625ad6ee55614ca3e38319986d2a1 to your computer and use it in GitHub Desktop.
install mcp server skill
name install-mcp
description MCPサーバのインストールと設定を行うスキル。プリセットから選択してClaude CodeやClaude Desktopにセットアップする。「MCPサーバをインストール」「MCP入れて」「MCPセットアップ」「MCP設定して」などの依頼で発動する。MCPサーバの追加・設定・導入に関する依頼には必ずこのスキルを使うこと。

MCP Server Installer

MCPサーバをプリセット一覧から選択してインストールするスキル。

プリセット一覧

以下のMCPサーバをサポートしている。ユーザーが名前で指定した場合は該当するものを、指定がなければ一覧を提示して選んでもらう。

Filesystem

ファイルシステムの読み書き操作を提供する。

  • パッケージ: @modelcontextprotocol/server-filesystem
  • 実行方法: npx -y @modelcontextprotocol/server-filesystem <許可ディレクトリ>
  • 必須パラメータ: アクセスを許可するディレクトリパス(1つ以上)
  • 環境変数: なし
{
  "filesystem": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]
  }
}

デフォルトで現在のディレクトリを提案し、ユーザーが必要に応じて変更できるようにする。 複数ディレクトリを指定する場合はスペース区切りで入力してもらう。

GitHub

GitHub API操作(リポジトリ、PR、Issue等)を提供する。

  • パッケージ: @modelcontextprotocol/server-github
  • 実行方法: npx -y @modelcontextprotocol/server-github
  • 必須パラメータ: なし
  • 環境変数: GITHUB_TOKEN(GitHub Personal Access Token)
{
  "github": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": {
      "GITHUB_TOKEN": "<your-github-token>"
    }
  }
}

ユーザーがトークンを持っていない場合は、GitHub Settings > Developer settings > Personal access tokens から作成する方法を案内する。

Fetch

Webページの取得・変換を提供する。URLからコンテンツを取得してMarkdown等に変換できる。

  • パッケージ: @modelcontextprotocol/server-fetch
  • 実行方法: npx -y @modelcontextprotocol/server-fetch
  • 必須パラメータ: なし
  • 環境変数: なし
{
  "fetch": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-fetch"]
  }
}

Context7

ライブラリやフレームワークの最新ドキュメントを取得する。ドキュメント検索に特化している。

  • パッケージ: @upstash/context7-mcp
  • 実行方法: npx -y @upstash/context7-mcp
  • 必須パラメータ: なし
  • 環境変数: なし
{
  "context7": {
    "command": "npx",
    "args": ["-y", "@upstash/context7-mcp"]
  }
}

AWS Documentation

AWSサービスのドキュメント検索・閲覧を提供する。サービス一覧の取得、ドキュメントの検索・読み込み、レコメンドなどが可能。

  • パッケージ: awslabs.aws-documentation-mcp-server(PyPI)
  • 実行方法: uvx awslabs.aws-documentation-mcp-server@latest
  • 必須パラメータ: なし
  • 環境変数: FASTMCP_LOG_LEVEL(ログレベル、ERROR推奨)、AWS_DOCUMENTATION_PARTITIONaws or aws-cn、デフォルト: aws
  • 前提条件: uv がインストールされていること(brew install uv
{
  "aws-documentation": {
    "command": "uvx",
    "args": ["awslabs.aws-documentation-mcp-server@latest"],
    "env": {
      "FASTMCP_LOG_LEVEL": "ERROR"
    }
  }
}

中国リージョンを使う場合は "AWS_DOCUMENTATION_PARTITION": "aws-cn"env に追加する。

AWS Terraform

AWS Terraformプロバイダーのリソース定義やベストプラクティスを検索・参照できる。

  • パッケージ: awslabs.terraform-mcp-server(PyPI)
  • 実行方法: uvx awslabs.terraform-mcp-server@latest
  • 必須パラメータ: なし
  • 環境変数: FASTMCP_LOG_LEVEL(ログレベル、ERROR推奨)
  • 前提条件: uv がインストールされていること(brew install uv
{
  "aws-terraform": {
    "command": "uvx",
    "args": ["awslabs.terraform-mcp-server@latest"],
    "env": {
      "FASTMCP_LOG_LEVEL": "ERROR"
    }
  }
}

インストール手順

1. ユーザーの意図を確認する

  • どのMCPサーバをインストールしたいか(指定がなければプリセット一覧を提示)
  • インストール先(デフォルト: プロジェクトレベル)

2. インストール先を決定する

インストール先 設定ファイル 用途
プロジェクト(デフォルト) <project-root>/.mcp.json そのプロジェクトでのみ使う
ユーザーローカル ~/.claude/settings.jsonmcpServers 全プロジェクトで使う
Claude Desktop ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) Claude Desktopアプリで使う

ユーザーが「グローバルに」「全プロジェクトで」と言ったらユーザーローカル、「Desktopで」「デスクトップアプリで」と言ったらClaude Desktopを選択する。明示的な指定がなければプロジェクトレベルに設定する。

3. 設定ファイルを編集する

プロジェクトレベル(.mcp.json)

.mcp.json がプロジェクトルートに存在するか確認し、なければ新規作成する。既存の場合は mcpServers にマージする。

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["..."],
      "env": {}
    }
  }
}

ユーザーローカル(settings.json)

~/.claude/settings.json を読み込み、mcpServers キーにマージする。既存の設定を壊さないよう注意する。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json を読み込み、mcpServers キーにマージする。ファイルやディレクトリが存在しない場合は作成する。

4. 必要なパラメータを収集する

MCPサーバによっては追加パラメータが必要:

  • Filesystem: 許可するディレクトリパスを聞く。ユーザーが指定しなければカレントディレクトリを提案する
  • GitHub: GITHUB_TOKEN を聞く。持っていない場合はトークン作成手順を案内する
  • AWS Documentation / AWS Terraform: uvx コマンドが必要。which uvx で確認し、なければ brew install uv を案内する

環境変数にシークレット値(トークン等)を設定する場合、値をそのまま設定ファイルに書くのではなく、環境変数参照や .env ファイルの利用を提案する。ただしユーザーが直接書き込みを望む場合はそれに従う。

5. 設定を書き込んで確認する

設定ファイルに書き込んだ後、内容を表示してユーザーに確認してもらう。

注意事項

  • 既存の設定を上書きしないこと。必ずマージする
  • 設定ファイルを編集する前に必ず現在の内容を読む
  • 環境変数のシークレット値は .env ファイルや環境変数経由での設定を推奨する
  • .mcp.json を新規作成した場合、.gitignore に追加するか確認する(トークン等が含まれる場合)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment