MCP Books Service

🚀 ブログプロジェクトにおけるMCPの実装

このプロジェクトは、ブログアプリケーションシステムでのModel Context Protocol (MCP)の実装を展示しています。言語モデルと構造化データ操作をシームレスに統合するために、3つの主要なコンポーネントが連携して動作します。

📦 インストール

1. Books MCP Serverのインストール

cd books-mcp-server
npm install
npm run build

2. Books Mock Serviceのインストール

cd books-mock-service
npm install
npm run dev

3. MCP Clientのインストール

cd mcp-client
# 仮想環境の作成とアクティブ化（推奨）
python -m venv .venv
source .venv/bin/activate  # Windowsの場合は：.venv\Scripts\activate
# 依存関係のインストール（requirements.txtファイルが必要）
pip install langchain-ollama mcp-use

🚀 クイックスタート

1. mockサービスの起動

cd books-mock-service
npm run dev

2. 新しいターミナルでクライアントを起動

cd mcp-client
python client.py

3. クエリの入力

入力したクエリを入力します。'exit'と入力すると終了します。

✨ 主な機能

1. Books MCP Server

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

• TypeScriptで構築され、型安全が保証されます。
• @modelcontextprotocol/sdkを使用してMCPを実装しています。
• stdioトランスポート層で動作します。

2. Books Mock Service

シンプルなExpress.jsサーバーで、書籍データサービスを模擬します。

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

3. MCP Client

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

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

📚 ドキュメント

プロジェクト構造

.
├── books-mcp-server/     # TypeScriptベースのMCPサーバー実装
│   ├── build/           # コンパイル後のJavaScriptファイル
│   ├── src/             # ソースTypeScriptファイル
│   └── package.json     # サーバーの依存関係とスクリプト
├── books-mock-service/  # 書籍データのモックサービス
│   └── server.js        # Express.jsのモックサーバー
└── mcp-client/         # PythonベースのMCPクライアント実装
    └── client.py       # メインのクライアントアプリケーション

🔧 開発に関する注意事項

• MCPサーバーはTypeScriptで構築されています。srcディレクトリで変更を加えた後は、npm run buildで再構築してください。
• モックサービスは、server.jsに新しいルートを追加することで拡張できます。
• クライアントは、必要に応じてclient.py内のLLM設定を変更できます。