Slim MCP

Slim-MCP: Claude Tools 🤖

🚀 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

📋 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.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

A lightweight, modular API service that provides useful tools like weather, date/time, calculator, search, email, and task management through a RESTful interface, designed for integration with AI agents and automated workflows.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Server for Asana
cristip73
-
security
A
license
-
quality
This server implementation allows AI assistants to interact with Asana's API, enabling users to manage tasks, projects, workspaces, and comments through natural language requests.
Last updated -
189
TypeScript
MIT License
Harvest MCP Server
taiste
A
security
A
license
A
quality
Integrates with Harvest time tracking API, enabling AI assistants to manage time entries, projects, clients, and tasks through natural language commands.
Last updated -
11
2
Python
MIT License
WordPress MCP Server
LiamCioci
-
security
A
license
-
quality
Enables AI assistants to interact with WordPress sites through the REST API. Supports multiple WordPress sites with secure authentication, enabling content management, post operations, and site configuration through natural language.
Last updated -
18
MIT License
Weather MCP Server
akaramanapp
A
security
F
license
A
quality
A Model Context Protocol server that provides AI agents with tools to retrieve weather alerts and detailed forecasts for US locations using the National Weather Service API.
Last updated -
2
80
TypeScript

View all related MCP servers