MCP Blog Project

MCP ブログプロジェクト

このプロジェクトでは、ブログアプリケーションシステムにおける Model Context Protocol（MCP）の実装を紹介します。言語モデルと構造化データ操作をシームレスに統合する、連携して動作する3つの主要コンポーネントで構成されています。

プロジェクト構成

.
├── books-mcp-server/     # TypeScript MCP server implementation
│   ├── build/           # Compiled JavaScript files
│   ├── src/             # Source TypeScript files
│   └── package.json     # Server dependencies and scripts
├── books-mock-service/  # Mock service for book data
│   └── server.js        # Express.js mock server
└── mcp-client/         # Python MCP client implementation
    └── client.py       # Main client application

コンポーネント

1. Books MCP サーバー

クライアントとモックサービス間の通信プロトコルを処理する、TypeScript ベースの MCP サーバーです。

• 型安全性を確保するために TypeScript で構築されています
• MCP の実装に @modelcontextprotocol/sdk を使用しています
• stdio トランスポート層で動作します

2. Books モックサービス

書籍データサービスをシミュレートするシンプルな Express.js サーバーです。

• 書籍関連の操作用にモックエンドポイントを提供します
• Express.js で構築されています
• 軽量で拡張も簡単です

3. MCP クライアント

MCP プロトコルを使用して言語モデルと連携する、Python ベースのクライアントです。

• LLM 連携に langchain_ollama を使用します
• クエリを処理する MCPAgent を実装しています
• 対話型の CLI インターフェースを提供します

セットアップ手順

1. Books MCP サーバーのセットアップ

cd books-mcp-server
npm install
npm run build

2. Books モックサービスのセットアップ

cd books-mock-service
npm install
npm run dev

3. MCP クライアントのセットアップ

cd mcp-client
# Create and activate virtual environment (recommended)
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
# Install dependencies (requirements.txt needed)
pip install langchain-ollama mcp-use

使用方法

1. モックサービスを起動します：

cd books-mock-service
npm run dev

2. 新しいターミナルを開き、クライアントを実行します：

cd mcp-client
python client.py

3. プロンプトが表示されたら、クエリを入力します。終了するには「exit」と入力します。

開発

• MCP サーバーは TypeScript で構築されています。src ディレクトリ内を変更し、npm run build を実行して再ビルドしてください
• server.js に新しいルートを追加して、モックサービスを拡張できます
• client.py の LLM 設定を変更して、クライアントをカスタマイズできます

依存関係

• MCP サーバーとモックサービスには Node.js と npm が必要です
• クライアントには Python 3.x が必要です
• ローカル LLM のサポートには Ollama が必要です
• package.json ファイルに記載された各種 npm パッケージ
• Python パッケージ：langchain-ollama、mcp-use