Multi-Capability Proxy Server

MCP (Multi-Capability Proxy) Server

This project implements a simple MCP server using Flask. The server can host multiple "tools," where each tool exposes functionalities by calling external REST APIs.

Project Structure

Setup and Running

1. Clone the repository (if applicable) or ensure all files are in place.
2. Create a virtual environment (recommended):
   python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
3. Install dependencies:
   pip install -r requirements.txt
4. Run the server:
   python mcp_server.py
   The server will start, by default on http://127.0.0.1:5001. It will also create the tools directory and a basic example_tool.py if they don't exist upon first run (though they are included in this setup).

Using the MCP Server

The server exposes the following endpoints:

• GET /: Lists all available tools and their descriptions.
• GET /<tool_name>/<action>?param1=value1&param2=value2: Executes an action for a specific tool using GET. Parameters are passed as query strings.
• POST /<tool_name>/<action>: Executes an action for a specific tool using POST. Parameters should be sent as a JSON body.

Example: Interacting with example_tool

The example_tool interacts with https://jsonplaceholder.typicode.com.

1. List available tools:
   curl http://127.0.0.1:5001/
   This will show example_tool and its available actions.
2. Get all posts (using example_tool):
   curl http://127.0.0.1:5001/example_tool/get_posts
3. Get a specific post by ID (using example_tool):
   curl http://127.0.0.1:5001/example_tool/get_post_by_id?id=1
4. Create a new post (using example_tool):
   curl -X POST -H "Content-Type: application/json" \ -d '{"data": {"title": "My New Post", "body": "This is the content.", "userId": 1}}' \ http://127.0.0.1:5001/example_tool/create_post

Adding New Tools

1. Create a new Python file in the tools/ directory (e.g., my_new_tool.py).
2. Implement the execute(action, params) function:
   • This function will receive the action name (string) and params (dictionary) from the request.
   • It should contain the logic to call the external API based on the action and params.
   • It must return a JSON-serializable dictionary or list.
3. Implement the get_tool_description() function:
   • This function should return a dictionary describing the tool, including its name, a general description, and a dictionary of available actions with their descriptions and parameters. See tools/example_tool.py for a template.
4. (Optional) Add configuration for your new tool in config.py and import it into your tool file.
5. Restart the MCP server. It will automatically detect and load the new tool.

Example structure for a new tool (tools/my_new_tool.py):

This provides a flexible way to extend the MCP server's capabilities.