Adampippert Multi Service MCP Server

🚀 Model Context Protocol (MCP) Server

The Model Context Protocol (MCP) Server is a web service built on the Flask framework. It provides interaction capabilities for multiple tools through a unified standard interface, supporting operations of tools such as GitHub, GitLab, Google Maps, Memory, and Puppeteer.

🚀 Quick Start

Architecture

The server adopts a modular architecture design, divided into the following core parts:

• Tool Manager: Responsible for tool registration, discovery, and invocation.
• Request Processing Layer: Parses user requests and distributes them to the corresponding tools.
• Response Generation Layer: Generates responses in a standard format based on the results returned by the tools.
• Documentation Generation Module: Automatically generates API documentation.

Features

Standard Interfaces

All tools interact with the server through the unified MCP protocol, supporting the following two invocation methods:

1. Unified Interface /mcp: Handles all cross - tool requests.
2. Tool - Specific Interfaces: Such as /tool/github/listRepos.

MCP Information Manifest

The /mcp/manifest endpoint is provided, which returns detailed descriptions of all available tools and their operations.

Tool Documentation

GitHub Tool

Supports the following operations:

• listRepos: Lists all repositories of a user or an organization.
• getRepo: Retrieves information about a specified repository.
• searchRepos: Searches for repositories that meet the specified criteria.
• getIssues: Retrieves the list of issues in a repository.
• createIssue: Creates a new issue in a repository.

GitLab Tool

Supports the following operations:

• listProjects: Lists all projects accessible to a user.
• getProject: Retrieves detailed information about a specified project.
• searchProjects: Searches for projects that meet the specified criteria.
• getIssues: Retrieves the list of issues in a project.
• createIssue: Creates a new issue in a project.
• getPipelines: Retrieves the pipeline information of a project.

Google Maps Tool

Supports the following operations:

• geocode: Converts an address to geographical coordinates.
• reverseGeocode: Converts geographical coordinates back to an address.
• getDirections: Retrieves the route planning between two points.
• searchPlaces: Searches for information about nearby places.
• getPlaceDetails: Retrieves detailed information about a specific place.

Memory Tool

Provides a persistent key - value storage service, supporting the following operations:

• get: Retrieves a stored item by its key.
• set: Creates or updates a stored item.
• delete: Deletes a stored item with a specified key.
• list: Lists all stored items, which can be filtered by conditions.
• search: Searches for stored items based on their content.

Puppeteer Tool

Provides web automation functionality, supporting the following operations:

• screenshot: Takes a snapshot of a web page.
• pdf: Generates a PDF file of a web page.
• extract: Extracts content information from a web page.

Contribution Guide

We welcome contributions from the community! Here's how you can participate:

Adding a New Tool

1. Create a new tool file in the tools directory, such as tools/newtool_tool.py.
2. Implement the specific operation methods of the tool, referring to the implementation patterns of existing tools.
3. Add the new tool to the manifest configuration.
4. Register the blueprint routes of the tool.

📄 License

This project is licensed under the MIT License. For detailed information, please refer to the LICENSE file.

Acknowledgments

We would like to thank the following projects for their contributions:

• The Model Context Protocol (MCP) provides the standard for the specification.
• The Flask framework lays the foundation for building the web service.
• Puppeteer provides powerful support for web automation.