mcp-servers

# MCP Server Pool This is an MCP (Model-Context-Protocol) Server repository that includes various practical MCP service implementations and a development tutorial from scratch. ## Project Structure ``` mcp-servers/ ├── git-options/ # MCP services related to Git operations ├── google-sheet-mcp/ # MCP services related to Google Sheets and document operations ├── jk-option/ # MCP services related to Jenkins operations ├── file-option/ # MCP services related to file operations ├── tutorial/ # MCP development tutorial from 0 to 1 └── ... # Other MCP services ``` ## Service List ### Git Operation Services Located in the `git-options/` directory, providing MCP services for Git-related operations, including: - Initialize repository - Add/commit changes - Branch management - Remote repository operations - Credential management - User configuration ### Google Sheets MCP Tools Located in the `google-sheet-mcp/` directory, providing MCP services for interacting with Google Sheets and Google Docs, including: - Document list query: List all accessible Google files, sheets, and documents - Document download: Download Google Sheets (supports Excel, CSV, JSON formats) and documents (supports DOCX, TXT formats) - Weekly report updates: Find and update weekly report content in Google Sheets - Secure authentication: Use Google service account for secure authentication ### Jenkins Operation Tools Located in the `jk-option/` directory, providing various operational features for Jenkins servers, including: - Retrieve the list of all Jenkins projects - Get build parameters for a specified project - Trigger builds based on incoming parameters - Get build status - Terminate specified builds - Project alias handling feature (e.g., mapping full project names to short aliases) ### File Operation Services Located in the `file-option/` directory, providing comprehensive file system operation capabilities, aimed at addressing the limitations of dialogue software like Cherry Studio in file operations: - Reading and writing files - Creating and deleting files - Copying and moving files - Creating and deleting directories - Modifying file permissions - Retrieving file information **Important Note**: When using file operation services, please exercise caution when performing delete operations, as these actions are real and irreversible once executed. ## MCP Development Tutorial from 0 to 1 Located in the `tutorial/` directory, this is a complete tutorial guiding you on how to develop MCP services from scratch: ### Tutorial Content 1. **Basic Concepts** - Introduction to MCP architecture - Service design principles - Setting up the development environment 2. **Creating Your First MCP Service** - Project structure setup - Writing the basic framework - Defining utility functions ## Development Guidelines ### Environment Requirements - Python 3.10+ - FastMCP library ## Module Submission To maintain consistency and maintainability of the repository, please follow these guidelines: ### Directory Structure Guidelines 1. **Each module must create an independent directory** - Each MCP service module must create a separate directory - Directory names should use lowercase letters and hyphens, e.g., `weather-service`, `text-translator` 2. **No need to include project framework files** - Do not submit the project's framework files - Focus on the specific implementation of the module ## Contribution Guidelines Contributions of new MCP services or improvements to existing services are welcome! ## License [MIT License](LICENSE)