Provides a REST API interface for the Model Context Protocol (MCP), allowing Python applications to interact with MCP resources, manage contexts, and utilize MCP capabilities through standard HTTP requests.
Uses TOML for project configuration and dependency management via pyproject.toml, enabling structured configuration of the MCP REST API server.
MCP REST API
Overview
This project implements a REST API server for the Model Context Protocol (MCP). It provides endpoints for managing and interacting with MCP resources.
Related MCP server: MCP-Guide
Project Structure
client.py: Handles client-side interactions.health_check.py: Implements health check endpoints for the server.logger_config.py: Configures logging for the application.mcp_server.py: Core server logic for the MCP REST API.middleware.py: Middleware components for request/response processing.server.py: Entry point for starting the server.pyproject.toml: Project configuration and dependencies.logs/: Directory containing log files (error.log,mcp_server.log).
Requirements
Python 3.12 or higher
Dependencies listed in
pyproject.toml
Setup
Clone the repository:
git clone <repository-url> cd mcp_restapiInstall dependencies:
pip install -e .
Running the Server
Start the server using the following command:
Logging
Log files are stored in the logs/ directory. The following logs are available:
error.log: Records error messages.mcp_server.log: General server logs.
Health Check
The health check endpoint can be accessed to verify the server's status. Refer to health_check.py for implementation details.
License
This project is licensed under the MIT License. See the LICENSE file for details.