mcp-toolbox

![Release](https://img.shields.io/github/v/release/ai-zerolab/mcp-toolbox) ![Build status](https://img.shields.io/github/actions/workflow/status/ai-zerolab/mcp-toolbox/main.yml?branch=main) ![codecov](https://codecov.io/gh/ai-zerolab/mcp-toolbox/branch/main/graph/badge.svg) ![Commit activity](https://img.shields.io/github/commit-activity/m/ai-zerolab/mcp-toolbox) ![License](https://img.shields.io/github/license/ai-zerolab/mcp-toolbox)

A comprehensive toolkit for enhancing LLM capabilities through the Model Context Protocol (MCP). This package provides a collection of tools that allow LLMs to interact with external services and APIs, extending their functionality beyond text generation.

GitHub repository: https://github.com/ai-zerolab/mcp-toolbox/

(WIP)Documentation: https://ai-zerolab.github.io/mcp-toolbox/

Features

*nix is our main target, but Windows should work too.

Command Line Execution: Execute any command line instruction through LLM

Figma Integration: Access Figma files, components, styles, and more

Extensible Architecture: Easily add new API integrations

MCP Protocol Support: Compatible with Claude Desktop and other MCP-enabled LLMs

Comprehensive Testing: Well-tested codebase with high test coverage

Installation

Using uv (Recommended)

We recommend using uv to manage your environment.

Then you can use uvx "mcp-toolbox@latest" stdio as commands for running the MCP server for latest version. Audio and memory tools are not included in the default installation., you can include them by installing the all extra:

[audio] for audio tools, [memory] for memory tools, [all] for all tools

Installing via Smithery

To install Toolbox for LLM Enhancement for Claude Desktop automatically via Smithery:

Using pip

And you can use mcp-toolbox stdio as commands for running the MCP server.

Configuration

Environment Variables

The following environment variables can be configured:

FIGMA_API_KEY: API key for Figma integration

TAVILY_API_KEY: API key for Tavily integration

DUCKDUCKGO_API_KEY: API key for DuckDuckGo integration

BFL_API_KEY: API key for Flux image generation API

Memory Storage

Memory tools store data in the following locations:

macOS: ~/Documents/zerolab/mcp-toolbox/memory (syncs across devices via iCloud)

Other platforms: ~/.zerolab/mcp-toolbox/memory

Full Configuration

To use mcp-toolbox with Claude Desktop/Cline/Cursor/..., add the following to your configuration file:

For full features:

You can generate a debug configuration template using:

Available Tools

Command Line Tools

[object Object]	[object Object]
[object Object]	[object Object]

File Operations Tools

[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]

Figma Tools

[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]

XiaoyuZhouFM Tools

[object Object]	[object Object]
[object Object]	[object Object]

Audio Tools

[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]

Memory Tools

[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]

Markitdown Tools

[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]

Web Tools

[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]

Flux Image Generation Tools

[object Object]	[object Object]
[object Object]	[object Object]

Usage Examples

Running the MCP Server

Using with Claude Desktop

Configure Claude Desktop as shown in the Configuration section

Start Claude Desktop

Ask Claude to interact with Figma files:

Ask Claude to execute command line instructions:

Ask Claude to download podcasts from XiaoyuZhouFM:

Ask Claude to work with audio files:

Ask Claude to convert files or URLs to Markdown:

Ask Claude to work with web content:

Ask Claude to generate images with Flux:

Ask Claude to use memory tools:

Development

Local Setup

Fork the repository and clone it to your local machine.

Running Tests

Running Checks

Building Documentation

Adding New Tools

To add a new API integration:

Update config.py with any required API keys

Create a new module in mcp_toolbox/

Implement your API client and tools

Add tests for your new functionality

Update the README.md with new environment variables and tools

See the development guide for more detailed instructions.

Contributing

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

Fork the repository

Create a 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 terms of the license included in the repository.

mcp-toolbox

GitHub repository: https://github.com/ai-zerolab/mcp-toolbox/

(WIP)Documentation: https://ai-zerolab.github.io/mcp-toolbox/

Features

*nix is our main target, but Windows should work too.

Command Line Execution: Execute any command line instruction through LLM

Figma Integration: Access Figma files, components, styles, and more

Extensible Architecture: Easily add new API integrations

MCP Protocol Support: Compatible with Claude Desktop and other MCP-enabled LLMs

Comprehensive Testing: Well-tested codebase with high test coverage

Installation

Using uv (Recommended)

We recommend using uv to manage your environment.

[audio] for audio tools, [memory] for memory tools, [all] for all tools

Installing via Smithery

To install Toolbox for LLM Enhancement for Claude Desktop automatically via Smithery:

Using pip

And you can use mcp-toolbox stdio as commands for running the MCP server.

Configuration

Environment Variables

The following environment variables can be configured:

FIGMA_API_KEY: API key for Figma integration

TAVILY_API_KEY: API key for Tavily integration

DUCKDUCKGO_API_KEY: API key for DuckDuckGo integration

BFL_API_KEY: API key for Flux image generation API

Memory Storage

Memory tools store data in the following locations:

macOS: ~/Documents/zerolab/mcp-toolbox/memory (syncs across devices via iCloud)

Other platforms: ~/.zerolab/mcp-toolbox/memory

Full Configuration

To use mcp-toolbox with Claude Desktop/Cline/Cursor/..., add the following to your configuration file:

For full features:

You can generate a debug configuration template using:

Available Tools

Command Line Tools

[object Object]	[object Object]
[object Object]	[object Object]

File Operations Tools

[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]

Figma Tools

[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]

XiaoyuZhouFM Tools

[object Object]	[object Object]
[object Object]	[object Object]

Audio Tools

[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]

Memory Tools

[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]

Markitdown Tools

[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]

Web Tools

[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]
[object Object]	[object Object]

Flux Image Generation Tools

[object Object]	[object Object]
[object Object]	[object Object]

Usage Examples

Running the MCP Server

Using with Claude Desktop

Configure Claude Desktop as shown in the Configuration section

Start Claude Desktop

Ask Claude to interact with Figma files:

Ask Claude to execute command line instructions:

Ask Claude to download podcasts from XiaoyuZhouFM:

Ask Claude to work with audio files:

Ask Claude to convert files or URLs to Markdown:

Ask Claude to work with web content:

Ask Claude to generate images with Flux:

Ask Claude to use memory tools:

Development

Local Setup

Fork the repository and clone it to your local machine.

Running Tests

Running Checks

Building Documentation

Adding New Tools

To add a new API integration:

Update config.py with any required API keys

Create a new module in mcp_toolbox/

Implement your API client and tools

Add tests for your new functionality

Update the README.md with new environment variables and tools

See the development guide for more detailed instructions.

Contributing

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

Fork the repository

Create a 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 terms of the license included in the repository.

Toolbox

mcp-toolbox

Features

Installation

Using uv (Recommended)

Installing via Smithery

Using pip

Configuration

Environment Variables

Memory Storage

Full Configuration

Available Tools

Command Line Tools

File Operations Tools

Figma Tools

XiaoyuZhouFM Tools

Audio Tools

Memory Tools

Markitdown Tools

Web Tools

Flux Image Generation Tools

Usage Examples

Running the MCP Server

Using with Claude Desktop

Development

Local Setup

Running Tests

Running Checks

Building Documentation

Adding New Tools

Contributing

License

mcp-toolbox

Features

Installation

Using uv (Recommended)

Installing via Smithery

Using pip

Configuration

Environment Variables

Memory Storage

Full Configuration

Available Tools

Command Line Tools

File Operations Tools

Figma Tools

XiaoyuZhouFM Tools

Audio Tools

Memory Tools

Markitdown Tools

Web Tools

Flux Image Generation Tools

Usage Examples

Running the MCP Server

Using with Claude Desktop

Development

Local Setup

Running Tests

Running Checks

Building Documentation

Adding New Tools

Contributing

License

Related servers

MagicSlides MCP Server

Time

CUA MCP Server

WhatsApp Bridge