F
licenseNot graded
qualityD
maintenanceEnables file system operations (read, write, list, search, watch, batch process) via MCP over JSON-RPC 2.0, used by a resume matching agent.
-
Filesystem MCP Server
MCP Integration Project — Resume Matching Agent
Hito 2: Reemplaza las importaciones directas de herramientas del sistema de archivos con un servidor Model Context Protocol (MCP) totalmente compatible con la especificación, consumido por un agente LangGraph.
Arquitectura
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)Archivos clave
File | Rol |
| Servidor MCP JSON-RPC 2.0 que expone 6 herramientas del sistema de archivos |
| Cliente MCP reutilizable con transporte stdio y gestión de subprocesos |
| Agente LangGraph: descubre y llama herramientas vía MCP |
| Pruebas unitarias para todos los métodos JSON-RPC (sin subprocesos) |
| Pruebas de integración con subproceso real y puente LangChain |
| 6 diagramas Mermaid del sistema |
Related MCP server: Filesystem MCP Server
Configuración
1. Instalar dependencias
pip install -r requirements.txt2. Configurar la clave de API
cp .env.example .env
# Edit .env and set OPENROUTER_API_KEYObtén una clave gratuita en openrouter.ai/keys.
Ejecución
Iniciar el Resume Matching Agent
python matching_agent.pyConsultas de ejemplo:
"Lista todos los currículos en la carpeta de currículos""Encuentra candidatos con habilidades en Python y ordénalos por experiencia""Lee todos los currículos por lotes y crea un informe de comparación de habilidades""Vigila la carpeta de currículos en busca de nuevos candidatos""Lee el currículo de Alice Johnson y escribe un resumen de un párrafo"
Probar el servidor MCP de forma independiente
# 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.pyEjecutar pruebas
# 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/ -vServidor MCP — Herramientas disponibles
Tool | Descripción |
| Lee archivos PDF, DOCX o TXT; devuelve texto + metadatos |
| Lista archivos en un directorio con filtro opcional |
| Escribe texto en un archivo (crea directorios si es necesario) |
| Búsqueda de palabras clave sin distinción de mayúsculas con contexto |
| NUEVO — Monitoreo de diferencias de instantáneas para archivos nuevos/modificados/eliminados |
| NUEVO — Procesamiento paralelo de múltiples archivos mediante ThreadPoolExecutor |
Servidor MCP — Métodos JSON-RPC
Método | Descripción |
| Protocolo de enlace MCP; devuelve las capacidades del servidor |
| Notificación de confirmación del cliente (sin respuesta) |
| Descubrimiento de recursos: lista las 6 herramientas con esquemas |
| Ejecuta una herramienta nombrada con argumentos |
| Lista los recursos del sistema de archivos (directorio de currículos) |
| Lee un recurso de archivo mediante URI |
| Comprobación de actividad |
Códigos de error JSON-RPC 2.0
Código | Nombre | Cuándo |
| Error de análisis | JSON no válido |
| Solicitud no válida | No es un mensaje JSON-RPC 2.0 válido |
| Método no encontrado | Nombre de método o herramienta desconocido |
| Parámetros no válidos | Tipos de argumentos faltantes o incorrectos |
| Error de herramienta | Falló la ejecución de la herramienta |
Diagramas de flujo de trabajo
Consulta diagrams/workflow_diagram.md para ver 6 diagramas Mermaid:
Resumen de la arquitectura del sistema
Máquina de estados de LangGraph
Flujo de mensajes JSON-RPC 2.0 (diagrama de secuencia completo)
Flujo de sondeo de
watch_directoryEjecución paralela de
batch_processFlujo de manejo de errores
Dependencia del Hito 1
Este proyecto es una refactorización de LLM-Powered-File-System-Assistant (Hito 1). Las 4 herramientas originales (read_file, list_files, write_file, search_in_file) se portan al servidor MCP. La importación directa import fs_tools en llm_file_assistant.py se reemplaza por la capa de protocolo MCP.
This server cannot be deployed
Maintenance
ActivitySlowing
ResponsivenessNo issues
Related MCP Connectors
Browse and manage files in your Moxt AI workspace from any MCP client.
Persistent file storage for AI agents via MCP and curl. Upload, download, and version files.
OCR, transcription, file extraction, and image generation for AI agents via MCP.
Document processing over MCP: merge, split and compress PDFs, run OCR, extract document text.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with a sandboxed filesystem via MCP tools for reading, writing, searching, and monitoring files, including batch processing and resource discovery for resume management.-
- FlicenseNot gradedqualityDmaintenanceProvides file system tools for resume matching agents, enabling reading, writing, searching, listing, watching, and batch processing of files via the Model Context Protocol.-
- FlicenseNot gradedqualityBmaintenanceProvides MCP tools for filesystem operations on resume directories, including watch, batch extraction, and saving match results.1-