Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/getfounded--mcp-tool-kit/badge.svg)](/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

i

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)

  1. # MCP Tool Kit
  2. A comprehensive toolkit for the Model Context Protocol (MCP) with automatic tool discovery and multiple transport options.
  3. [![PyPI version](https://img.shields.io/pypi/v/mcptoolkit.svg)](https://pypi.org/project/mcptoolkit/)
  4. [![Python versions](https://img.shields.io/pypi/pyversions/mcptoolkit.svg)](https://pypi.org/project/mcptoolkit/)
  5. [![License](https://img.shields.io/github/license/getfounded/mcp-tool-kit.svg)](https://github.com/getfounded/mcp-tool-kit/blob/main/LICENSE)
  6. πŸ“š **[Official Documentation](https://docs.mcp-tool-kit.com)** | 🌐 **[Website](https://mcp-tool-kit.com)** | πŸ’¬ **[Community](https://github.com/getfounded/mcp-tool-kit/discussions)**
  7. ---
  8. πŸš€ **Built by [UsefulAI](https://usefulai.ai)** | πŸ“– **[From GitHub to Commercial Success](https://usefulai.ai/blog/articles/from-github-to-commercial-success)**
  9. ## πŸš€ Quick Install - No Git Required!
  10. Choose your platform and run ONE command:
  11. ### πŸ–₯️ Windows (PowerShell)
  12. ```powershell
  13. irm https://raw.githubusercontent.com/getfounded/mcp-tool-kit/main/install.ps1 | iex
  14. ```
  15. ### 🍎 macOS (Terminal)
  16. ```bash
  17. 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
  18. ```
  19. ### 🐧 Linux (Terminal)
  20. ```bash
  21. 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
  22. ```
  23. **That's it!** The installer will:
  24. - βœ… Download MCP Tool Kit (no Git needed!)
  25. - βœ… Check for Docker (helps install if missing)
  26. - βœ… Create desktop shortcuts
  27. - βœ… Set up everything automatically
  28. ## πŸ“¦ Alternative Installation Methods
  29. <details>
  30. <summary>Manual Download</summary>
  31. 1. Download the latest release:
  32. - [Windows: MCP-Tool-Kit-Windows.zip](https://github.com/getfounded/mcp-tool-kit/releases/latest)
  33. - [Mac/Linux: MCP-Tool-Kit-Unix.tar.gz](https://github.com/getfounded/mcp-tool-kit/releases/latest)
  34. 2. Extract and run:
  35. - **Windows**: Run `install.bat`
  36. - **Mac/Linux**: Run `./install.sh`
  37. </details>
  38. <details>
  39. <summary>Git Installation (for developers)</summary>
  40. 1. **Clone the repository**
  41. ```bash
  42. git clone https://github.com/getfounded/mcp-tool-kit.git
  43. cd mcp-tool-kit
  44. ```
  45. 2. **Run the launcher**
  46. - **Windows**: Double-click `launch.bat`
  47. - **Mac/Linux**: Run `./launch.sh`
  48. </details>
  49. <details>
  50. <summary>Docker-Only Installation</summary>
  51. ```bash
  52. docker run -it --name mcp-toolkit ghcr.io/getfounded/mcp-tool-kit:latest
  53. ```
  54. </details>
  55. ## πŸ”§ Features
  56. ### Dynamic Tool Registration
  57. Tools are automatically discovered and registered at runtime - no manual configuration needed!
  58. ### Multiple Transport Options
  59. - **stdio**: For Claude Desktop integration
  60. - **SSE (Server-Sent Events)**: For web-based access
  61. ### 120+ Available Tools
  62. - πŸ“ **File System**: Read, write, and manage files
  63. - πŸ• **Time Tools**: Timezone conversions and time operations
  64. - 🌐 **Web Search**: Brave Search integration
  65. - πŸ€– **Browser Automation**: Playwright-based browser control
  66. - πŸ“Š **Data Analysis**: Yahoo Finance, FRED, World Bank data
  67. - πŸ“„ **Document Tools**: PDF, Excel, PowerPoint manipulation
  68. - 🎯 **And many more!**
  69. ### Easy Configuration
  70. Control everything through a simple `config.yaml` file:
  71. ```yaml
  72. enabled_tools:
  73. filesystem: true
  74. time_tools: true
  75. brave_search: true
  76. # ... more tools
  77. tool_config:
  78. filesystem:
  79. allowed_directories: ["~/Documents", "~/Downloads"]
  80. brave_search:
  81. max_results: 10
  82. ```
  83. ## πŸ“‹ Environment Setup
  84. 1. Copy `.env.template` to `.env`
  85. 2. Add your API keys:
  86. ```env
  87. BRAVE_SEARCH_API_KEY=your_key_here
  88. NEWS_API_KEY=your_key_here
  89. FRED_API_KEY=your_key_here
  90. # ... other keys
  91. ```
  92. ## πŸ’Ύ Storage Setup
  93. MCP Tool Kit uses a dedicated storage directory for file operations:
  94. - **Windows**: `C:\Users\{Username}\mcp-tool-kit-storage`
  95. - **Mac/Linux**: `~/mcp-tool-kit-storage`
  96. ### Automatic Setup
  97. The storage directory is automatically created when you first run the Docker container. You can also manually set it up:
  98. **Windows (PowerShell)**:
  99. ```powershell
  100. .\scripts\setup-storage.ps1
  101. ```
  102. **Mac/Linux**:
  103. ```bash
  104. ./scripts/setup-storage.sh
  105. ```
  106. ### Storage Structure
  107. ```
  108. mcp-tool-kit-storage/
  109. β”œβ”€β”€ documents/ # For document files
  110. β”œβ”€β”€ downloads/ # For downloaded files
  111. └── workspace/ # For temporary work files
  112. ```
  113. All file operations through the filesystem tool will be restricted to this directory for security.
  114. ## πŸ”Œ Connecting to Claude Desktop
  115. 1. Start the server in stdio mode using the launcher
  116. 2. Add to Claude Desktop configuration:
  117. ```json
  118. {
  119. "mcpServers": {
  120. "mcp-tool-kit": {
  121. "command": "docker",
  122. "args": ["exec", "-i", "mcp-server", "python", "mcp_server_v2.py"]
  123. }
  124. }
  125. }
  126. ```
  127. ## 🌐 Using SSE Mode
  128. 1. Start the server in SSE mode using the launcher
  129. 2. Access the server at `http://localhost:8080`
  130. 3. Use the SSE endpoints:
  131. - `/sse` - Server-Sent Events stream
  132. - `/messages` - Send messages to the server
  133. ## πŸ› οΈ Creating Custom Tools
  134. Tools now use a standardized base class system:
  135. ```python
  136. from app.tools.base_tool import BaseTool
  137. class MyCustomTool(BaseTool):
  138. def get_name(self) -> str:
  139. return "My Custom Tool"
  140. def get_tools(self) -> Dict[str, Callable]:
  141. return {
  142. "my_function": self.my_function
  143. }
  144. async def my_function(self, param: str, ctx: Context = None) -> str:
  145. return f"Processed: {param}"
  146. ```
  147. See the [developer documentation](https://docs.mcp-tool-kit.com) for detailed guides.
  148. ## πŸ“š Documentation
  149. Full documentation is available at [https://docs.mcp-tool-kit.com](https://docs.mcp-tool-kit.com).
  150. To run documentation locally:
  151. 1. `cd docs`
  152. 2. `npm install`
  153. 3. `npm start`
  154. ## 🐳 Docker Commands
  155. ### Using the Launcher (Recommended)
  156. The launcher scripts handle all Docker operations automatically.
  157. ### Manual Commands
  158. ```bash
  159. # Start server
  160. docker-compose up -d
  161. # View logs
  162. docker-compose logs -f
  163. # Stop server
  164. docker-compose down
  165. # Rebuild after changes
  166. docker-compose build --no-cache
  167. ```
  168. ## 🀝 Contributing
  169. 1. Fork the repository
  170. 2. Create your feature branch
  171. 3. Add your tool to `app/tools/`
  172. 4. Submit a pull request
  173. ## πŸ“„ License
  174. This project is licensed under the MIT License - see the LICENSE file for details.
  175. ## πŸ†˜ Support
  176. - [GitHub Issues](https://github.com/getfounded/mcp-tool-kit/issues)
  177. - [Documentation](https://docs.mcp-tool-kit.com)
  178. - [Discord Community](#) (coming soon)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.