This MCP server collection provides a set of specialized services for enabling multi-agent collaboration. The Python-based services include a system cleaner that handles cross-platform maintenance tasks and a logistics module that aggregates and queries domestic operations data. The TypeScript services offer a file management interface for manipulating and organizing files, and a data analyzer for processing and deriving insights from datasets. To use a specific service, start the corresponding server from its project (as defined in the mcp_config) and connect your agents to its exposed APIs. Agents can coordinate by invoking the provided endpoints for tasks such as cleanup routines, logistics lookups, file operations, and analytical processing. The collection is designed to be extended with additional MCP servers by adding new entries under mcpServers with the appropriate command and arguments.

Prerequisites:

• Python 3.12+ for Python-based servers
• Node.js 14+ for TypeScript-based servers
• Git to clone the repository

Installation steps:

1. Clone the repository: git clone https://github.com/mcpchina/mcpchina-mcp-servers.git cd mcpchina-mcp-servers

2. Install Python dependencies for Python servers (if required by each project):

   • Create and activate a virtual environment: python -m venv venv

     Windows

     venv\Scripts\activate

     macOS/Linux

     source venv/bin/activate
   • Install packages for a given Python server (example): pip install -r python/mcp-system-cleaner/requirements.txt

3. Install Node.js dependencies for TypeScript servers: cd typescript/mcp-file-manager npm install

   Repeat for mcp-data-analyzer

4. Start servers (examples):

   Python servers

   python -m mcp_system_cleaner python -m mcp_logistics

   TypeScript servers (assuming server.js entry points exist after build)

   node typescript/mcp-file-manager/server.js node typescript/mcp-data-analyzer/server.js

5. Verify servers are running and accessible via their APIs. Update environment variables as needed in the mcp_config.

Tips:

• Ensure each Python server module is importable and its entry point matches the -m module name used in mcp_config.
• If a server requires API keys or external services, set the corresponding environment variables in mcp_config.env or your hosting environment.
• For TS servers, you may need to compile/transpile TS to JS before running server.js; ensure your build step (tsc) is executed if required by the project structure.
• Use consistent logging levels (MCP_LOG_LEVEL) to facilitate debugging across services.
• When extending the collection, keep a consistent naming convention for new servers and document their API contracts for agent developers.