Slim-MCP: Claude Tools 🤖

Python 3.11+ License: MIT GitHub stars Twitter Follow

🚀 Supercharge Claude with powerful Python-based tools via the MCP protocol

✨ Features

🧮 Calculator: Perform complex math calculations
🌦️ Weather: Get current weather forecasts and alerts
🕒 DateTime: Access current time in local and UTC formats
🔌 Extensible: Easily add custom tools with simple Python functions
💻 Desktop Integration: Seamless integration with Claude Desktop app
🖱️ Cursor IDE: Native integration with Cursor IDE for developers

Related MCP server: XiaoZhi MCP Aggregate

📋 Table of Contents

🚀 Installation

Prerequisites

Python 3.11+
Conda (recommended)

Setup with Conda (Recommended)

# Create conda environment with Python 3.11 conda create -n mcp-tools python=3.11 # Activate environment conda activate mcp-tools # Clone the repository git clone https://github.com/webdevtodayjason/slim-MCP.git cd slim-MCP # Install with uv (preferred) uv pip install -e . # OR install with standard pip pip install -e .

🎮 Usage

Configure Claude

Add this to your Claude configuration file:

{ "mcpServers": { "claude-tools": { "command": "/path/to/conda/envs/mcp-tools/bin/python", "args": ["-m", "claude_tools.main"] } } }

Configure Cursor IDE

NAME: claude-tools TYPE: command COMMAND: /path/to/conda/envs/mcp-tools/bin/python -m claude_tools.main

Example Prompts

Can you calculate 25^3 + sqrt(196)? What's the current time in UTC? What's the weather like in Austin, TX?

🔌 Integrations

Claude AI Desktop: Primary integration via MCP protocol
Cursor IDE: Direct integration for development workflows
Claude Web: Compatible with Claude Web through configuration

💻 Development

Project Structure

slim-MCP/ ├── src/ │ └── claude_tools/ │ ├── __init__.py │ ├── calculator.py # Math calculation tool │ ├── datetime_tool.py # Date and time utilities │ ├── main.py # Entry point │ └── weather.py # Weather forecasting tool ├── http_server.py # HTTP server for MCP ├── pyproject.toml # Project configuration ├── .gitignore # Git ignore file └── LICENSE # MIT License

Creating a New Tool

Create a new Python file in src/claude_tools/:

# src/claude_tools/my_tool.py def my_awesome_function(param: str) -> str: """Description of what this tool does. Args: param: Description of the parameter Returns: A string with the result """ result = f"Processed: {param}" return result def register_my_tools(mcp): """Register all my tools with the MCP server.""" mcp.tool()(my_awesome_function)

Import and register your tool in __init__.py:

# In src/claude_tools/__init__.py from .calculator import register_calculator_tools from .datetime_tool import register_datetime_tools from .weather import register_weather_tools from .my_tool import register_my_tools # Add this line def register_all_tools(mcp): register_calculator_tools(mcp) register_datetime_tools(mcp) register_weather_tools(mcp) register_my_tools(mcp) # Add this line

Restart the server and your new tool is ready to use!

👥 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Slim MCP