MCP Employee API Server

# MCP Employee API Server A Model Context Protocol (MCP) server that provides tools for managing employee data through a REST API. This server exposes employee management operations as MCP tools that can be used by AI assistants and other MCP clients. ## Features - **Employee Management**: Full CRUD operations for employee data - **REST API Integration**: Connects to a local employee API server - **MCP Protocol**: Exposes functionality through the Model Context Protocol - **Async Operations**: Built with async/await for optimal performance - **Error Handling**: Robust error handling for API requests ## Available Tools The server provides the following MCP tools: - `get_employees()` - Retrieve all employees - `get_employee(id)` - Get a specific employee by ID - `add_employee(name, age)` - Create a new employee - `update_employee(id, name, age)` - Update an existing employee - `delete_employee(id)` - Delete an employee by ID ## Prerequisites - Python 3.13 or higher - A running employee API server at `http://localhost:8000` ## Installation 1. Clone the repository: ```bash git clone https://github.com/JoseGarayar/mcp_test.git cd mcp_test ``` 2. Clone the api employee repository: ```bash git clone https://github.com/JoseGarayar/api_employees.git ``` 2. Install dependencies using uv: ```bash uv sync ``` ## Usage ### Running the MCP Server Start the MCP server using stdio transport: ```bash uv run python main.py ``` The server will run and listen for MCP protocol messages via stdin/stdout. ### API Configuration The server is configured to connect to a local API server at `http://localhost:8000`. You can modify the `URL_BASE` constant in `main.py` to point to a different API endpoint. ### Example API Endpoints The server expects the following API endpoints to be available: - `GET /employees` - List all employees - `GET /employees/{id}` - Get employee by ID - `POST /employees` - Create new employee - `PUT /employees/{id}` - Update employee - `DELETE /employees/{id}` - Delete employee ## Development ### Project Structure ``` mcp_test/ ├── main.py # Main MCP server implementation ├── pyproject.toml # Project configuration and dependencies ├── README.md # This file └── uv.lock # Lock file for dependencies ``` ### Dependencies - `httpx` - Async HTTP client for API requests - `mcp[cli]` - Model Context Protocol implementation ### Development Dependencies - `ruff` - Python linter and formatter ## Error Handling The server includes comprehensive error handling: - Network timeouts (30 seconds) - HTTP error status codes - Invalid HTTP methods - Connection failures All errors are gracefully handled and return `None` for failed operations. ## License This project is part of a test implementation for MCP server development.