Filesystem MCP Server
MCP統合プロジェクト — 履歴書マッチングエージェント
マイルストーン2: 直接のファイルシステムツールインポートを、完全に仕様準拠の**Model Context Protocol (MCP)**サーバーに置き換え、LangGraphエージェントが利用します。
アーキテクチャ
User
│
▼
matching_agent.py (LangGraph state machine)
│
│ JSON-RPC 2.0 over stdio
▼
mcp_client.py (subprocess manager + RPC transport)
│
▼
filesystem_mcp_server.py (MCP server, 6 tools)
│
▼
resumes/ (file system)主要ファイル
ファイル | 役割 |
| JSON-RPC 2.0 MCPサーバーで、6つのファイルシステムツールを公開 |
| サブプロセス管理付きの再利用可能なstdioトランスポートMCPクライアント |
| LangGraphエージェント — MCP経由でツールを発見・呼び出し |
| すべてのJSON-RPCメソッドのユニットテスト（サブプロセスなし） |
| 実際のサブプロセス + LangChainブリッジを使った統合テスト |
| システムの6つのMermaid図 |
セットアップ
1. 依存関係のインストール
pip install -r requirements.txt2. APIキーの設定
cp .env.example .env
# Edit .env and set OPENROUTER_API_KEY無料のキーは openrouter.ai/keys で取得できます。
実行
履歴書マッチングエージェントを起動
python matching_agent.pyクエリの例:
"resumesフォルダ内のすべての履歴書を一覧表示""Pythonスキルを持つ候補者を検索し、経験でランク付け""すべての履歴書を一括読み取り、スキル比較レポートを作成""resumesフォルダを監視して新しい候補者を検出""Alice Johnsonの履歴書を読み、1段落の要約を書く"
MCPサーバーを単体でテスト
# Send a raw JSON-RPC request
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.1"}}}' | python filesystem_mcp_server.py
# Test the MCP client
python mcp_client.pyテストの実行
# Unit tests (fast, no subprocess)
python -m pytest tests/test_mcp_server.py -v
# Integration tests (spawns subprocess)
python -m pytest tests/test_agent.py -v -s
# All tests
python -m pytest tests/ -vMCPサーバー — 利用可能なツール
ツール | 説明 |
| PDF、DOCX、TXTファイルを読み取り、テキスト+メタデータを返す |
| ディレクトリ内のファイルを一覧表示（オプションのフィルター付き） |
| テキストをファイルに書き込む（必要に応じてディレクトリを作成） |
| 大文字小文字を区別しないキーワード検索（コンテキスト付き） |
| NEW — 新規/変更/削除されたファイルのスナップショット差分監視 |
| NEW — ThreadPoolExecutorによる並列マルチファイル処理 |
MCPサーバー — JSON-RPCメソッド
メソッド | 説明 |
| MCPハンドシェイク; サーバー機能を返す |
| クライアント確認通知（応答なし） |
| リソース発見 — 6つのツールすべてをスキーマ付きで一覧表示 |
| 指定されたツールを引数付きで実行 |
| ファイルシステムリソース（resumesディレクトリ）を一覧表示 |
|
|
| 生存確認 |
JSON-RPC 2.0 エラーコード
コード | 名前 | 発生時 |
| パースエラー | 無効なJSON |
| 無効なリクエスト | 有効なJSON-RPC 2.0メッセージではない |
| メソッドが見つからない | 不明なメソッドまたはツール名 |
| 無効なパラメータ | 引数の型が欠落/誤り |
| ツールエラー | ツールの実行に失敗 |
ワークフロー図
6つのMermaid図については diagrams/workflow_diagram.md を参照してください:
システムアーキテクチャ概要
LangGraph状態機械
JSON-RPC 2.0メッセージフロー（完全なシーケンス図）
watch_directoryポーリングフローbatch_process並列実行エラーハンドリングフロー
マイルストーン1への依存
このプロジェクトは LLM-Powered-File-System-Assistant（マイルストーン1）のリファクタリングです。元の4つのツール（read_file、list_files、write_file、search_in_file）はMCPサーバーに移植されています。llm_file_assistant.py 内の直接の import fs_tools はMCPプロトコル層に置き換えられています。
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
OCR, transcription, file extraction, and image generation for AI agents via MCP.
Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.
A paid remote MCP for hosted MCP server, built to return verdicts, receipts, usage logs, and audit-r
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/abrarsavan123/mcp-integration-project'
If you have feedback or need assistance with the MCP directory API, please join our Discord server