Oh My MCP

哦，我的mcp

一个功能强大的模型上下文协议（MCP）服务器 116实用工具 跨越9个类别，使用 FastMCP.

     

🚀 特性

哦，我的mcp提供了以下工具：

• 📦 压缩 （5个工具）：具有安全功能的ZIP/TAR压缩和提取
• 🌐 Web和网络 （18个工具）：Web搜索、页面获取、HTML解析、下载、HTTP API客户端、DNS查找
• 📁 文件系统 （12个工具）：读取、写入、搜索文件和目录、文件比较
• 📊 数据处理 （15个工具）：JSON、CSV、XML、YAML、TOML解析和操作
• 📝 文本处理 （9个工具）：正则表达式、编码、电子邮件/URL提取、文本相似性
• 💻 系统 （8个工具）：系统信息、CPU/内存监控、环境变量
• 🛠️ 公用事业 （10个工具）：UUID、哈希、日期/时间操作、数学、密码生成
• 🤖 子代理AI （6个工具）：将子任务委托给外部AI模型（OpenAI/Anthropic）、并行执行、条件分支、持久配置
• 🌐 浏览器自动化 （33个工具）：基于Selenium的浏览器控制、页面导航、元素交互、屏幕截图、JavaScript执行、多标签管理

注： Python开发、UV包管理器和Pylance/Pyright工具已从打包版本中删除，因为它们需要外部Python解释器和包管理器。所有剩余的工具完全独立工作。

📚 文档

• 📖 文档索引 - Complete documentation hub (中文)
• 🏗️ 项目结构 -详细的项目组织
• 🎯 安装指南 -交互式配置向导指南
• 📦 构建指南 -Windows/Linux发行版软件包
• 🏛️ 架构指南 -系统架构与设计
• 🧪 子代理指南 -AI编排功能

⚡ 快速安装与配置

1. 安装依赖并开发模式安装：

pip install -e .

1. 运行交互式配置向导（推荐）：

uv run configure.py

或直接为Claude Desktop生成配置：

python -m mcp_server.cli.config --claude

或启动HTTP配置服务：

python -m mcp_server.cli.config --http-server --port 8765

详细配置说明见：docs/zh/SETUP_GUIDE.md

1. 启动MCP服务：

python -m mcp_server.main

启动后可通过Claude Desktop或MCP客户端连接使用。

📦 安装

先决条件

• Python 3.12或更高版本
• pip包管理器

______________________________________________________________________

______________________________________________________________________

📚 工具参考

有关工具、使用示例和API详细信息的完整列表，请参阅 docs/en/TOOL_REFERENCE.md.

🔧 配置

日志记录

日志配置在 mcp_server/utils.py。您可以调整：

• 日志级别（信息、调试、警告、错误）
• 输出目标（控制台、文件）
• 日志格式

文件大小限制

文件操作有安全限制：

• read_file：最大文件大小为10MB
• safe_write_file：自动创建父目录

安全功能

• 路径验证：防止路径遍历攻击
• 安全评价：数学表达式只允许安全操作
• 隐藏值：敏感环境变量被屏蔽
• 需要确认：文件删除需要 confirm=True
• 重试逻辑：网络操作最多重试3次

______________________________________________________________________

🛡️ 错误处理

所有工具都包括全面的错误处理：

• 验证错误：输入参数无效
• 网络错误：网络请求失败
• 文件操作错误：文件系统错误
• 数据处理错误：数据解析/转换错误

错误以JSON格式返回，并带有描述性消息。

______________________________________________________________________

📝 发展

项目结构

oh-my-mcp/
├── pyproject.toml               # Dependencies
├── configure.py                 # Interactive setup wizard
├── README.md                    # Documentation
└── src/
    └── mcp_server/
        ├── __init__.py              # Package init
        ├── main.py                  # Server entry point
        ├── utils.py                 # Infrastructure & utilities
        ├── command_executor.py      # Secure command execution
        ├── cli/
        │   └── config.py            # Configuration generator
        └── tools/                   # Tool plugins (9 categories)
            ├── __init__.py          # Plugin auto-discovery
            ├── registry.py          # @tool_handler & ToolPlugin
            ├── search_engine.py     # Web search backend
            ├── subagent_config.py   # Subagent config manager
            ├── compression/         # Compression tools (5)
            ├── web/                 # Web & Network tools (18)
            ├── file/                # File System tools (12)
            ├── data/                # Data Processing tools (15)
            ├── text/                # Text Processing tools (9)
            ├── system/              # System tools (8)
            ├── utility/             # Utility tools (10)
            └── subagent/            # AI Orchestration tools (6)

添加新工具

在相应的插件中创建一个新工具 handlers.py:

from mcp_server.tools.registry import tool_handler

@tool_handler
def your_tool(param: str) -> str:
    """Tool description.

    Args:
        param: Parameter description

    Returns:
        Return value description
    """
    try:
        # Your implementation
        return result
    except Exception as e:
        logger.error(f"Tool failed: {e}")
        return f"Error: {str(e)}"

测试

使用MCP客户端或FastMCP测试实用程序启动服务器和测试工具。

______________________________________________________________________

🤝 贡献

欢迎投稿！需要改进的地方：

• 其他工具类别
• 增强的错误处理
• 性能优化
• 更全面的测试
• 其他外部API集成

______________________________________________________________________

📄 许可证

本项目按原样提供，用于教育和实际用途。

______________________________________________________________________

🔗 链接

• FastMCP文档
• 模型上下文协议（MCP）
• DuckDuckGo搜索

______________________________________________________________________

📖 其他资源

文档

• 📚 文档中心 - Complete documentation index (中文)
• 🏗️ 项目结构 -项目组织指南
• 🏛️ 建筑 -系统架构与设计
• 📋 测试报告 -测试套件

配置和设置

• ⚙️ 配置指南（CN） -完整的配置参考
• 🎯 安装指南 -分步设置说明

构建和部署

• 📦 构建指南 -Windows/Linux软件包
• 🚀 安装指南 -安装细节

高级功能

• 🤖 子代理配置 -AI任务委托设置
• 🧠 子代理指南 -AI编排功能
• 🔍 高级搜索 -搜索功能详细信息

开发人员资源

• 🏛️ 架构指南 -系统架构与设计
• 🤝 贡献指南 -如何做出贡献
• 📝 更新日志 -版本历史

______________________________________________________________________

🔧 配置管理

配置生成器工具

这 python -m mcp_server.cli.config 命令提供了多种配置MCP客户端的方法：

# Quick install to Claude Desktop
python -m mcp_server.cli.config --claude

# Run HTTP server on custom port
python -m mcp_server.cli.config --http-server --port 9000

# Generate config file with custom server name
python -m mcp_server.cli.config --server-name my-tools --output config.json

# Show configuration in console
python -m mcp_server.cli.config --show-config

配置服务器端点

跑步时 --http-server:

示例用法：

# Start server on port 8765
python -m mcp_server.cli.config --http-server

# Get configuration
curl http://localhost:8765/config

# Get server info
curl http://localhost:8765/info

______________________________________________________________________

享受哦，我的mcp！ 🚀