MCP Tool Kit

🚀 MCP Toolkit

The MCP Toolkit represents a paradigm shift in the relationship between humans and artificial intelligence. It establishes a cognitive partnership where human strategic thinking and AI operational capabilities complement each other, rather than simply using AI for task automation.

🚀 Quick Start

Installation Guide

Clone the Repository

Use the following command to clone the MCP Toolkit repository:

git clone git@github.com:your-username/mcp-tool-kit.git
cd mcp-tool-kit

Install Dependencies

Run the following command to install the Python dependencies required for the project:

pip install -r requirements.txt

Configure Environment Variables (Windows)

To add Git to the system path, follow these steps:

1. Open the "Edit the system environment variables" application, which can be found via the Control Panel or by searching for it.
2. In the "System variables" section, find the "Path" variable and click "Edit...".
3. Add the paths of the Git installation directory (e.g., C:\Program Files\Git\bin and C:\Program Files\Git\cmd).
4. After saving the changes, reopen the Command Prompt window to apply the new PATH settings.

Start the Service

Run the following command to start the MCP unified server:

python mcp_unified_server.py

Configuration Guide

Add all API keys and configuration parameters to the config.json file:

{
  "news_api_key": "your-news-api-key",
  "world_bank_api_key": "your-world-bank-api-key",
  "git_path": "C:\\Program Files\\Git\\bin"
}

✨ Features

Tool Expansion

Add a New Tool Module

1. Create a new Python file (e.g., my_tool.py) in the tools directory.
2. Implement the functionality following the pattern of existing modules:
   • Create a service class.
   • Define tool functions.
   • Implement a registration function.
3. Update mcp_unified_server.py to import and register the new module.

Extend an Existing Tool Module

1. Add new methods to the service class.
2. Implement new functionality in the tool functions.
3. Update the registration function to include the new tool.

Docker Development Environment

Using Docker for development ensures environment consistency:

# Build the development image
docker build -t mcp-tool-kit:dev .

# Run the container in development mode
docker run -p 8000:8000 \
    -v $(pwd):/app \
    -v ~/documents:/app/documents \
    mcp-tool-kit:dev

This command mounts the local code and document directories into the container, so code changes take effect immediately (for most files).

Philosophical Perspective: Human-Machine Cognitive Partnership

The MCP Toolkit represents a paradigm shift in the relationship between humans and artificial intelligence. It no longer views AI as a simple task - automation tool but establishes a cognitive partnership where human strategic thinking and AI operational capabilities complement each other.

This agent architecture embodies a transformative vision: AI systems can independently interpret context, make decisions within defined parameters, and execute complex operation sequences while maintaining human supervision and strategic guidance. This is not only a technological advancement but also a new model of human - machine collaboration.

In this evolving cognitive landscape, the most successful implementations will be those that carefully balance technological potential with human capabilities, creating interfaces that enhance rather than replace human decision - making and creativity.

🔧 Technical Details

Troubleshooting

• Module not loaded: Check import paths and dependencies.
• API key error: Verify the configuration in the .env file.
• Git path issue: Ensure it has been correctly added to the system PATH.
• Startup failure: Check the log output for detailed error information.

Further Reading

It is recommended to refer to the following resources for a deeper understanding of the functionality and usage of the MCP Toolkit:

1. Official Documentation
2. Developer Blog
3. Community Forum

By following these guides, you should be able to configure and use the MCP Toolkit smoothly. If you encounter any problems during the process, feel free to refer to the troubleshooting section or contact the support team for assistance.