Toolbox

🚀 MCP 工具箱

MCP 工具箱提供了一系列实用工具，涵盖文件操作、命令行执行、音频处理等多种功能。通过简单的配置，可实现与 Claude Desktop 的通信，为用户提供便捷的操作体验。

🚀 快速开始

安装

使用 pip 即可轻松完成安装：

pip install mcp-toolbox

配置

配置 MCP 服务器与 Claude Desktop 的通信，在 config.py 文件中添加以下配置：

# 配置 MCP 服务器的默认地址和端口
DEFAULT_HOST = "localhost"
DEFAULT_PORT = 9870

# 配置标准传输 (stdio)
TRANSPORTS = {
    "stdio": {}
}

# 配置 SSE 传输所需的额外设置
SSE_TRANSPORT_SETTINGS = {
    "host": DEFAULT_HOST,
    "port": DEFAULT_PORT,
    "path": "/ws"
} 

# 添加 Claude Desktop 的 MCP 连接配置
CLAUDE_MCP_CONFIG = {
    "mcp_url": "http://localhost:9870",
    "timeout": 30
}

✨ 主要特性

可用工具列表

1. Figma 文件操作：可获取 Figma 文件信息、检查组件以及查看评论。
2. 命令行执行：支持列出当前目录文件、查询系统时间、显示特定文件内容等操作。
3. Xiaoyu Zhou FM 下载：能下载 podcast 集并转换为 MP3 格式。
4. 音频处理：可计算音频时长、提取指定时间段的文本。
5. 文件与网页转 Markdown：可将本地文件和网页内容转换为 Markdown 格式。
6. 网络操作：能获取网页 HTML 内容、保存网页到本地文件，还可使用 Tavily 和 DuckDuckGo 搜索引擎。
7. 图像生成：利用 Flux API 创建图像并保存。
8. 记忆工具：可存储重要信息、查看当前会话 ID、回忆存储内容、思考特定主题以及清除所有记忆。

📦 安装指南

使用 pip 安装：

pip install mcp-toolbox

💻 使用示例

基础用法

启动 MCP 服务器

# 使用标准传输（默认）
mcp-toolbox stdio

# 使用 SSE 传输
mcp-toolbox sse --host localhost --port 9871

配合 Claude Desktop 使用

1. 按照配置指南设置 Claude Desktop。
2. 启动 Claude Desktop。
3. 请求获取 Figma 文件信息：
   • "你能提供这个 Figma 文件的信息吗：12345abcde?"
   • "展示这个 Figma 文件的组件：12345abcde"
   • "提取这个 Figma 文件的评论：12345abcde"

📚 详细文档

本地开发环境搭建

# 以开发者模式安装
make 安装
# 激活虚拟环境
source .venv/bin/activate  # macOS/Linux 系统使用
# 或者
.venv\Scripts\activate  # Windows 系统使用

运行测试

make 测试

执行检查

make 检查

📄 许可证

本项目遵循 MIT 许可证协议。

如需更多详细信息，请参阅 MCP 工具箱官方文档。