MCP サーバーの例

このリポジトリには、教育目的のモデルコンテキストプロトコル（MCP）サーバーの実装が含まれています。このコードは、様々なLLMクライアントと統合できる機能的なMCPサーバーの構築方法を示しています。

完全なチュートリアルを実行するには、 YouTube ビデオチュートリアルを参照してください。

MCPとは何ですか?

MCP（モデル・コンテキスト・プロトコル）は、アプリケーションがLLMにコンテキストを提供する方法を標準化するオープンプロトコルです。MCPはAIアプリケーション用のUSB-Cポートのようなもので、AIモデルをさまざまなデータソースやツールに接続するための標準化された方法を提供します。

MCP図

主なメリット

LLMに直接接続できる、構築済みの統合のリストが増えています
LLMプロバイダーとベンダーを切り替える柔軟性
インフラストラクチャ内でデータを保護するためのベストプラクティス

アーキテクチャの概要

MCP は、ホストアプリケーションが複数のサーバーに接続できるクライアントサーバーアーキテクチャに従います。

MCPホスト: Claude Desktop、IDE、またはMCPを介してデータにアクセスするAIツールなどのプログラム
MCPクライアント: サーバーとの1:1接続を維持するプロトコルクライアント
MCP サーバー: 標準化されたモデルコンテキストプロトコルを通じて特定の機能を公開する軽量プログラム
データソース: MCP サーバーがアクセスできるローカル (ファイル、データベース) とリモートサービス (API) の両方

MCPコアコンセプト

MCP サーバーは、主に次の 3 種類の機能を提供できます。

リソース: クライアントが読み取ることができるファイルのようなデータ (API レスポンスやファイルの内容など)
ツール: LLM から呼び出せる関数 (ユーザーの承認が必要)
プロンプト: ユーザーが特定のタスクを達成するのに役立つ、事前に作成されたテンプレート

システム要件

Python 3.10以上
MCP SDK 1.2.0以上
uvパッケージマネージャー

はじめる

uv パッケージマネージャーのインストール

MacOS/Linuxの場合:

curl -LsSf https://astral.sh/uv/install.sh | sh

uvコマンドが確実に実行されるように、後でターミナルを再起動してください。

プロジェクトのセットアップ

プロジェクトを作成して初期化します。

# Create a new directory for our project
uv init mcp-server
cd mcp-server

# Create virtual environment and activate it
uv venv
source .venv/bin/activate  # On Windows use: .venv\Scripts\activate

# Install dependencies
uv add "mcp[cli]" httpx

サーバー実装ファイルを作成します。

touch main.py

サーバーの実行

MCP サーバーを起動します。

uv run main.py

サーバーが起動し、接続を受け入れる準備が整います

Claudeデスクトップに接続しています

公式サイトからClaude Desktopをインストールする
MCP サーバーを使用するように Claude Desktop を構成します。

~/Library/Application Support/Claude/claude_desktop_config.jsonを編集します。

{
    "mcpServers": {
        "mcp-server": {
            "command": "uv",  # It's better to use the absolute path to the uv command
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/YOUR/mcp-server",
                "run",
                "main.py"
            ]
        }
    }
}

Claudeデスクトップを再起動します

トラブルシューティング

サーバーが Claude Desktop によって取得されていない場合は、次の手順に従ってください。

設定ファイルのパスと権限を確認してください
設定内の絶対パスが正しいことを確認します
UVが適切に設置され、アクセス可能であることを確認する
Claude Desktopのログにエラーメッセージがないか確認してください

ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細はLICENSEファイルをご覧ください。

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

get_docs

Claude Desktop などのさまざまな LLM クライアントと統合するための機能的な MCP サーバーを構築する方法を示す、モデルコンテキストプロトコルサーバーの教育用実装です。

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP-Guide
qpd-v
A
security
A
license
A
quality
A beginner-friendly Model Context Protocol (MCP) server that helps users understand MCP concepts, provides interactive examples, and lists available MCP servers. This server is designed to be a helpful companion for developers working with MCP. Also comes with a huge list of servers you can install.
Last updated -
3
9
36
JavaScript
Apache 2.0
URL Fetch MCP
aelaguiz
-
security
A
license
-
quality
A Model Context Protocol (MCP) server that enables Claude or other LLMs to fetch content from URLs, supporting HTML, JSON, text, and images with configurable request parameters.
Last updated -
Python
MIT License
MCP Maker
CaptainCrouton89
-
security
-
license
-
quality
A specialized server that helps users create new Model Context Protocol (MCP) servers by providing tools and templates for scaffolding projects with various capabilities.
Last updated -
1
TypeScript
mcp-framework-starter
QuantGeekDev
-
security
F
license
-
quality
A starter template for building Model Context Protocol (MCP) servers, enabling developers to create and add custom tools that can be integrated with Claude Desktop.
Last updated -
TypeScript

View all related MCP servers

Appeared in Searches

Latest Next.js Documentation

MCP Server Example