┌─────────────────────────┐     JSON-RPC 2.0 (TCP)    ┌─────────────────────────────┐
│   matching_agent.py     │ ◄──────────────────────── │  filesystem_mcp_server.py   │
│   (LangGraph + GPT-4)   │ ──────────────────────── ►│  (MCP Server, port 8765)    │
│                         │                            │                             │
│  Nodes:                 │   tools/call → result      │  Tools exposed:             │
│  1. load_job_desc       │                            │  • read_file                │
│  2. load_resumes        │                            │  • write_file               │
│  3. watch_new_resumes   │                            │  • list_directory           │
│  4. match_candidates────┼──► GPT-4o (OpenAI API)    │  • search_files             │
│  5. save_report         │                            │  • get_file_info            │
└─────────────────────────┘                            │  • delete_file              │
                                                       │  • watch_directory ★        │
                                                       │  • batch_process ★          │
                                                       └─────────────────────────────┘

pip install -r requirements.txt
export OPENAI_API_KEY="sk-..."

python filesystem_mcp_server.py --transport tcp --port 8765

python matching_agent.py --jd job_descriptions/senior_engineer.txt --resumes resumes/

python -m pytest tests/ -v

python demo_runner.py

Client → initialize (protocolVersion, capabilities)
Server → {protocolVersion, capabilities, serverInfo}
Client → initialized  (notification, no response)

→ {"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"batch_process","arguments":{...}}}
← {"jsonrpc":"2.0","id":3,"result":{"content":[{"type":"text","text":"{...}"}],"isError":false}}

{"event": "file_created", "path": "resumes/new_candidate.txt", "timestamp": "...", "size_bytes": 1234}