MCP Server
A modular Model Control Protocol (MCP) server that provides tools for interacting with GitHub repositories.
Features
- Modular design with extensible tool handlers
- Support for both HTTP and stdio transport
- GitHub repository analysis tools
- Command execution capability
- CORS support for cross-origin requests
Installation
- Install the required dependencies:
pip install -r requirements.txt
Usage
HTTP Mode
Start the server in HTTP mode with optional host and port:```
python server.py --http --host 0.0.0.0 --port 8000
This will start the server and make it accessible at `http://localhost:8000` (or the specified host/port).
### Stdio Mode
Start the server in stdio mode for direct pipe-based communication:```
python server.py
This mode is used when the MCP server is called directly by a client through stdin/stdout.
Available Tools
The server provides the following tools:
- get_time: Get the current time
- calculate: Perform simple calculations
- get_weather: Get mock weather data for a location
- github_repo: Clone and analyze GitHub repositories
- execute_command: Execute commands in the system shell
API Endpoints
When running in HTTP mode, the server provides the following endpoints:
- GET /initialize: Initialize the connection and get available tools
- GET /list_tools: List all available tools
- POST /execute_tool: Execute a specific tool with arguments
Example API Usage
Execute a Tool```
POST /execute_tool
Content-Type: application/json
{
"name": "github_repo",
"arguments": {
"action": "clone",
"repo_url": "https://github.com/example/repo.git"
}
}
## Extending the Server
To add a new tool:
1. Create a new handler class in the `handlers` directory that extends `BaseHandler`
2. Implement the `execute` method in your handler
3. Register your handler in the `_setup_handlers` method in `server.py`
4. Create a corresponding tool definition in the `_setup_tools` method
## Testing
The server includes a comprehensive set of unit tests using pytest and pytest-asyncio.
### Running Tests
To run the tests:```
pytest
For more verbose output:```
pytest -v
To run tests with code coverage:```
pytest --cov=handlers --cov=utils
Adding New Tests
When adding new handlers, create corresponding test files in the tests directory:
- Create a test file named
test_yourhandler.py - Use pytest fixtures from
conftest.pywhere appropriate - Write tests for all public methods in your handler
