🚀 通过 MCP 协议为 Claude 提供强大的基于 Python 的工具
✨ 特点
- 🧮计算器:执行复杂的数学计算
- 🌦️天气:获取当前天气预报和警报
- 🕒 DateTime :以本地和 UTC 格式访问当前时间
- 🔌可扩展:使用简单的 Python 函数轻松添加自定义工具
- 💻桌面集成:与 Claude 桌面应用程序无缝集成
- 🖱️ Cursor IDE :为开发人员提供与 Cursor IDE 的原生集成
📋 目录
🚀 安装
先决条件
使用 Conda 设置(推荐)
# 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 .
🎮 使用方法
配置 Claude
将其添加到您的 Claude 配置文件中:
{
"mcpServers": {
"claude-tools": {
"command": "/path/to/conda/envs/mcp-tools/bin/python",
"args": ["-m", "claude_tools.main"]
}
}
}
配置 Cursor IDE
NAME: claude-tools
TYPE: command
COMMAND: /path/to/conda/envs/mcp-tools/bin/python -m claude_tools.main
示例提示
Can you calculate 25^3 + sqrt(196)?
What's the current time in UTC?
What's the weather like in Austin, TX?
🔌 集成
- Claude AI Desktop :通过 MCP 协议进行初步集成
- Cursor IDE :直接集成开发工作流程
- Claude Web :通过配置兼容 Claude Web
💻 开发
项目结构
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
创建新工具
- 在
src/claude_tools/
中创建一个新的 Python 文件:
# 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)
- 在
__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
- 重新启动服务器,您的新工具就可以使用了!
👥 贡献
欢迎贡献代码!欢迎提交 Pull 请求。
- 分叉存储库
- 创建你的功能分支(
git checkout -b feature/amazing-feature
) - 提交您的更改(
git commit -m 'Add some amazing feature'
) - 推送到分支(
git push origin feature/amazing-feature
) - 打开拉取请求
📄 许可证
该项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅LICENSE文件。