MCPとは？初心者のための環境構築から使い方までの入門

「context」とは

contextの語源は「文脈」や「状況」という意味です。

MCPでは「モデルが利用できる外部の情報やリソース」を context と呼びます。

つまり、AIモデルがユーザーの入力（プロンプト）だけではなく、必要に応じて追加で参照できる周辺情報を「コンテキスト」として扱う仕組みです。

MCPはAIのための「USB-C」のようなものにたとえられます。

USB-Cケーブル一本で、様々なデバイス（PC、スマホ、モニター）を繋げられるように、MCPという共通のルールを通して、AIと様々なツールやデータを安全に連携させることができるのです。

公式サイト：https://modelcontextprotocol.io

GitHub：https://github.com/modelcontextprotocol

身近な例で考えてみよう

普段スマートフォンでアプリを使うとき、「写真アプリ」が他のアプリである「電話帳」にアクセスしたり、「地図アプリ」が位置情報を使ったりしますよね。

これと同じように、MCPはAIが様々なツール（ファイル操作、データベース、ウェブ検索など）を使えるようにする仕組みなのです。

1. 3つの主要コンポーネント

• MCP Client（青）: Claude Desktopなど、ツールを使いたいAIアプリ
• MCP Protocol（赤）: JSON-RPC 2.0による通信プロトコル
• MCP Server（緑）: 実際の機能を提供するツール群

2. 双方向通信

• リクエスト/レスポンスの流れを矢印で表現
• プロトコルが中間層として両者を繋ぐ役割

3. 具体的な動作フロー

• 5段階のステップで実際の処理の流れを表示
• ユーザー要求から結果表示までの全プロセス

MCPが解決できる事

例えばこれまでの問題点

MCPでできることの具体例

必要なもの

• パソコン（Windows、Mac、Linux対応）
• インターネット接続
• 基本的なプログラミング知識（あると良い）

ステップ1: Node.jsのインストール

MCPの多くのツールはNode.jsで作られています。
動作させるにはNode.jsをインストールしておく必要があります。

# Homebrewを使用（推奨）
brew install node

# または公式サイトからダウンロード

# Homebrewを使用（推奨）
brew install node

# または公式サイトからダウンロード

node --version
npm --version

node --version
npm --version

ステップ2: Claude Desktopのインストール

1. Claude公式サイトからClaude Desktopをダウンロード
2. インストーラーを実行
3. アカウントでログイン

ステップ3: 最初のMCPサーバーを試してみよう

自分のパソコンのファイルをAIに操作させるファイルシステムサーバーの例：

# MCPサンプルプロジェクトをクローン
git clone https://github.com/modelcontextprotocol/servers.git
cd servers/src/filesystem

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

# サーバーを起動
npm start

# MCPサンプルプロジェクトをクローン
git clone https://github.com/modelcontextprotocol/servers.git
cd servers/src/filesystem

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

# サーバーを起動
npm start

ステップ4: Claude Desktopとの連携設定

//Claude Desktopの設定ファイル（claude_desktop_config.json）を編集：
{
  "mcpServers": {
    "filesystem": {
      "command": "node",
      "args": ["/path/to/servers/src/filesystem/index.js"],
      "env": {
        "NODE_ENV": "development"
      }
    }
  }
}

//Claude Desktopの設定ファイル（claude_desktop_config.json）を編集：
{
  "mcpServers": {
    "filesystem": {
      "command": "node",
      "args": ["/path/to/servers/src/filesystem/index.js"],
      "env": {
        "NODE_ENV": "development"
      }
    }
  }
}

~/Library/Application Support/Claude/claude_desktop_config.json

C:\Users\<ユーザー名>\AppData\Roaming\Claude\claude_desktop_config.json

ファイル操作の例

Claude Desktopを開いて、以下のように話しかけてみましょう：

"デスクトップに新しいフォルダ'my_project'を作成してください"

"デスクトップに新しいフォルダ'my_project'を作成してください"

"そのフォルダにreadme.txtファイルを作成して、プロジェクトの概要を書いてください"

"そのフォルダにreadme.txtファイルを作成して、プロジェクトの概要を書いてください"

データ処理の例

"CSVファイルを読み込んで、売上データの集計をしてください"

"CSVファイルを読み込んで、売上データの集計をしてください"

Cursor側の特徴：

• Client のみ: CursorエディタはMCP Clientとしてのみ動作
• Host機能なし: サーバー管理は行わない
• 外部依存: MCPサーバーは完全に独立したプロセスとして動作

設定方法の違い

CursorではMCP設定を ~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト単位）で管理 Cursor – Model Context Protocol (MCP)し、各サーバーは独立してユーザーが起動・管理する必要があります。

実際の動作の違い

Claude Desktop:

User → Claude Desktop → 内部MCPサーバー → 結果
       (Client+Host)    (内部プロセス)

User → Claude Desktop → 内部MCPサーバー → 結果
       (Client+Host)    (内部プロセス)

Cursor:

User → Cursor Editor → 外部MCPサーバー → 結果
       (Client のみ)   (独立プロセス)

User → Cursor Editor → 外部MCPサーバー → 結果
       (Client のみ)   (独立プロセス)

それぞれの利点・欠点：

Claude Desktop（統合型）:

• ✅ 簡単セットアップ
• ✅ 統一管理
• ❌ 柔軟性制限

Cursor（分離型）:

• ✅ 高い柔軟性
• ✅ プロジェクト単位設定
• ✅ 他のツール（VS Code、Claude Code等）との共有可能
• ❌ 複雑な設定・管理

Cursorでは「MCPサーバーが外部コンテキストをCursorに持ち込むブリッジとして機能し、Google DriveやNotionなどのサービスへの接続を可能にする」 Cursor – Model Context Protocol (MCP)という設計思想です。

つまり、Cursorは開発者により多くの制御権と柔軟性を与える代わりに、設定の複雑さを受け入れるというアプローチを取っているのです。

Q: MCPサーバーが起動しない

A: 以下を確認してください：

• Node.jsが正しくインストールされているか
• パスが正しく設定されているか
• 必要な権限があるか

Q: セキュリティは大丈夫？

A: MCPは以下の安全機能があります：

• サンドボックス環境での実行
• 権限ベースのアクセス制御
• 透明性のあるログ記録

Q: プログラミング知識がなくても使える？

A: 基本的な使い方なら可能ですが、カスタマイズには多少の知識が必要です。

おすすめのMCPサーバー

その他、MCP Marketなどでさまざまなサーバーが公開されています。

自分でオリジナルのMCPサーバーを作るには

以下のようなオリジナルサーバーを作ったとしてます。

// 簡単なMCPサーバーの例
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

const server = new Server({
  name: 'my-custom-server',
  version: '1.0.0'
});

// ツールの定義
server.setRequestHandler(ListToolsRequestSchema, async () => {
  return {
    tools: [{
      name: 'hello',
      description: 'Say hello',
      inputSchema: {
        type: 'object',
        properties: {
          name: { type: 'string' }
        }
      }
    }]
  };
});

// サーバー起動
async function main() {
  const transport = new StdioServerTransport();
  await server.connect(transport);
}

main();

// 簡単なMCPサーバーの例
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

const server = new Server({
  name: 'my-custom-server',
  version: '1.0.0'
});

// ツールの定義
server.setRequestHandler(ListToolsRequestSchema, async () => {
  return {
    tools: [{
      name: 'hello',
      description: 'Say hello',
      inputSchema: {
        type: 'object',
        properties: {
          name: { type: 'string' }
        }
      }
    }]
  };
});

// サーバー起動
async function main() {
  const transport = new StdioServerTransport();
  await server.connect(transport);
}

main();

MCPサーバーを利用するための設定方法を説明します。

Claude Desktop での設定

Claude DesktopでMCPサーバーを使用するには、設定ファイルを編集します。

~/Library/Application Support/Claude/claude_desktop_config.json

C:\Users\<ユーザー名>\AppData\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "my-custom-server": {
      "command": "node",
      "args": ["/path/to/your/server.js"]
    }
  }
}

{
  "mcpServers": {
    "my-custom-server": {
      "command": "node",
      "args": ["/path/to/your/server.js"]
    }
  }
}

{
  "mcpServers": {
    "my-custom-server": {
      "command": "node",
      "args": ["/Users/username/projects/mcp-server/index.js"]
    },
    "another-server": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-example"]
    }
  }
}

{
  "mcpServers": {
    "my-custom-server": {
      "command": "node",
      "args": ["/Users/username/projects/mcp-server/index.js"]
    },
    "another-server": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-example"]
    }
  }
}

「太郎」という名前でhelloツールを使って挨拶して

「太郎」という名前でhelloツールを使って挨拶して

こんにちは、太郎さん!

こんにちは、太郎さん!