mcp-tool-kit
Agentic abstraction layer for building high precision vertical AI agents written in python for Model Context Protocol.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/getfounded--mcp-tool-kit)HTML
<a href="/listings/getfounded--mcp-tool-kit"><img src="/api/listings/getfounded--mcp-tool-kit/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
Choose your platform and run ONE command:
π₯οΈ Windows (PowerShell)
irm https://raw.githubusercontent.com/getfounded/mcp-tool-kit/main/install.ps1 | iex
π macOS (Terminal)
bash <(curl -s https://raw.githubusercontent.com/getfounded/mcp-tool-kit/main/install.sh)
π§ Linux (Terminal)
bash <(wget -qO- https://raw.githubusercontent.com/getfounded/mcp-tool-kit/main/install.sh)
**That's it!** The installer will: - β Download MCP Tool Kit (no Git needed!) - β Check for Docker (helps install if missing) - β Create desktop shortcuts - β Set up everything automatically
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md Β· README Β· 241 lines Β· 3 findings marked
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # MCP Tool Kit
- A comprehensive toolkit for the Model Context Protocol (MCP) with automatic tool discovery and multiple transport options.
- [](https://pypi.org/project/mcptoolkit/)
- [](https://pypi.org/project/mcptoolkit/)
- [](https://github.com/getfounded/mcp-tool-kit/blob/main/LICENSE)
- π **[Official Documentation](https://docs.mcp-tool-kit.com)** | π **[Website](https://mcp-tool-kit.com)** | π¬ **[Community](https://github.com/getfounded/mcp-tool-kit/discussions)**
- ---
- π **Built by [UsefulAI](https://usefulai.ai)** | π **[From GitHub to Commercial Success](https://usefulai.ai/blog/articles/from-github-to-commercial-success)**
- ## π Quick Install - No Git Required!
- Choose your platform and run ONE command:
- ### π₯οΈ Windows (PowerShell)
- ```powershell
- irm https://raw.githubusercontent.com/getfounded/mcp-tool-kit/main/install.ps1 | iex
- Note: Runs a downloaded PowerShell script (iex / Invoke-Expression)
- Line 21 on GitHub
- ```
- ### π macOS (Terminal)
- ```bash
- bash <(curl -s https://raw.githubusercontent.com/getfounded/mcp-tool-kit/main/install.sh)
- Note: Runs a downloaded script through process substitution (bash <(curl β¦))
- Line 26 on GitHub
- ```
- ### π§ Linux (Terminal)
- ```bash
- bash <(wget -qO- https://raw.githubusercontent.com/getfounded/mcp-tool-kit/main/install.sh)
- Note: Runs a downloaded script through process substitution (bash <(curl β¦))
- Line 31 on GitHub
- ```
- **That's it!** The installer will:
- - β Download MCP Tool Kit (no Git needed!)
- - β Check for Docker (helps install if missing)
- - β Create desktop shortcuts
- - β Set up everything automatically
- ## π¦ Alternative Installation Methods
- <details>
- <summary>Manual Download</summary>
- 1. Download the latest release:
- - [Windows: MCP-Tool-Kit-Windows.zip](https://github.com/getfounded/mcp-tool-kit/releases/latest)
- - [Mac/Linux: MCP-Tool-Kit-Unix.tar.gz](https://github.com/getfounded/mcp-tool-kit/releases/latest)
- 2. Extract and run:
- - **Windows**: Run `install.bat`
- - **Mac/Linux**: Run `./install.sh`
- </details>
- <details>
- <summary>Git Installation (for developers)</summary>
- 1. **Clone the repository**
- ```bash
- git clone https://github.com/getfounded/mcp-tool-kit.git
- cd mcp-tool-kit
- ```
- 2. **Run the launcher**
- - **Windows**: Double-click `launch.bat`
- - **Mac/Linux**: Run `./launch.sh`
- </details>
- <details>
- <summary>Docker-Only Installation</summary>
- ```bash
- docker run -it --name mcp-toolkit ghcr.io/getfounded/mcp-tool-kit:latest
- ```
- </details>
- ## π§ Features
- ### Dynamic Tool Registration
- Tools are automatically discovered and registered at runtime - no manual configuration needed!
- ### Multiple Transport Options
- - **stdio**: For Claude Desktop integration
- - **SSE (Server-Sent Events)**: For web-based access
- ### 120+ Available Tools
- - π **File System**: Read, write, and manage files
- - π **Time Tools**: Timezone conversions and time operations
- - π **Web Search**: Brave Search integration
- - π€ **Browser Automation**: Playwright-based browser control
- - π **Data Analysis**: Yahoo Finance, FRED, World Bank data
- - π **Document Tools**: PDF, Excel, PowerPoint manipulation
- - π― **And many more!**
- ### Easy Configuration
- Control everything through a simple `config.yaml` file:
- ```yaml
- enabled_tools:
- filesystem: true
- time_tools: true
- brave_search: true
- # ... more tools
- tool_config:
- filesystem:
- allowed_directories: ["~/Documents", "~/Downloads"]
- brave_search:
- max_results: 10
- ```
- ## π Environment Setup
- 1. Copy `.env.template` to `.env`
- 2. Add your API keys:
- ```env
- BRAVE_SEARCH_API_KEY=your_key_here
- NEWS_API_KEY=your_key_here
- FRED_API_KEY=your_key_here
- # ... other keys
- ```
- ## πΎ Storage Setup
- MCP Tool Kit uses a dedicated storage directory for file operations:
- - **Windows**: `C:\Users\{Username}\mcp-tool-kit-storage`
- - **Mac/Linux**: `~/mcp-tool-kit-storage`
- ### Automatic Setup
- The storage directory is automatically created when you first run the Docker container. You can also manually set it up:
- **Windows (PowerShell)**:
- ```powershell
- .\scripts\setup-storage.ps1
- ```
- **Mac/Linux**:
- ```bash
- ./scripts/setup-storage.sh
- ```
- ### Storage Structure
- ```
- mcp-tool-kit-storage/
- βββ documents/ # For document files
- βββ downloads/ # For downloaded files
- βββ workspace/ # For temporary work files
- ```
- All file operations through the filesystem tool will be restricted to this directory for security.
- ## π Connecting to Claude Desktop
- 1. Start the server in stdio mode using the launcher
- 2. Add to Claude Desktop configuration:
- ```json
- {
- "mcpServers": {
- "mcp-tool-kit": {
- "command": "docker",
- "args": ["exec", "-i", "mcp-server", "python", "mcp_server_v2.py"]
- }
- }
- }
- ```
- ## π Using SSE Mode
- 1. Start the server in SSE mode using the launcher
- 2. Access the server at `http://localhost:8080`
- 3. Use the SSE endpoints:
- - `/sse` - Server-Sent Events stream
- - `/messages` - Send messages to the server
- ## π οΈ Creating Custom Tools
- Tools now use a standardized base class system:
- ```python
- from app.tools.base_tool import BaseTool
- class MyCustomTool(BaseTool):
- def get_name(self) -> str:
- return "My Custom Tool"
- def get_tools(self) -> Dict[str, Callable]:
- return {
- "my_function": self.my_function
- }
- async def my_function(self, param: str, ctx: Context = None) -> str:
- return f"Processed: {param}"
- ```
- See the [developer documentation](https://docs.mcp-tool-kit.com) for detailed guides.
- ## π Documentation
- Full documentation is available at [https://docs.mcp-tool-kit.com](https://docs.mcp-tool-kit.com).
- To run documentation locally:
- 1. `cd docs`
- 2. `npm install`
- 3. `npm start`
- ## π³ Docker Commands
- ### Using the Launcher (Recommended)
- The launcher scripts handle all Docker operations automatically.
- ### Manual Commands
- ```bash
- # Start server
- docker-compose up -d
- # View logs
- docker-compose logs -f
- # Stop server
- docker-compose down
- # Rebuild after changes
- docker-compose build --no-cache
- ```
- ## π€ Contributing
- 1. Fork the repository
- 2. Create your feature branch
- 3. Add your tool to `app/tools/`
- 4. Submit a pull request
- ## π License
- This project is licensed under the MIT License - see the LICENSE file for details.
- ## π Support
- - [GitHub Issues](https://github.com/getfounded/mcp-tool-kit/issues)
- - [Documentation](https://docs.mcp-tool-kit.com)
- - [Discord Community](#) (coming soon)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If itβs helped, pass it on.