{"id":28768472,"url":"https://github.com/getfounded/mcp-tool-kit","last_synced_at":"2026-04-04T16:19:00.595Z","repository":{"id":281100437,"uuid":"944208977","full_name":"getfounded/mcp-tool-kit","owner":"getfounded","description":"Agentic abstraction layer for building high precision vertical AI agents written in python for Model Context Protocol.","archived":false,"fork":false,"pushed_at":"2025-07-25T00:38:24.000Z","size":122577,"stargazers_count":94,"open_issues_count":2,"forks_count":14,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-20T15:26:59.793Z","etag":null,"topics":["agentic-ai","enterprise","generative-ai","llm","mcp","mcp-server","modelcontextprotocol","python"],"latest_commit_sha":null,"homepage":"https://docs.mcp-tool-kit.com/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/getfounded.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-07T00:53:02.000Z","updated_at":"2025-08-20T06:37:32.000Z","dependencies_parsed_at":null,"dependency_job_id":"0598abe7-180b-46db-89d7-5d5256195675","html_url":"https://github.com/getfounded/mcp-tool-kit","commit_stats":null,"previous_names":["getfounded/mcp-tool-kit"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/getfounded/mcp-tool-kit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getfounded%2Fmcp-tool-kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getfounded%2Fmcp-tool-kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getfounded%2Fmcp-tool-kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getfounded%2Fmcp-tool-kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/getfounded","download_url":"https://codeload.github.com/getfounded/mcp-tool-kit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getfounded%2Fmcp-tool-kit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31405700,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-ai","enterprise","generative-ai","llm","mcp","mcp-server","modelcontextprotocol","python"],"created_at":"2025-06-17T13:03:07.273Z","updated_at":"2026-04-04T16:19:00.587Z","avatar_url":"https://github.com/getfounded.png","language":"Python","funding_links":[],"categories":["📚 Projects (1974 total)","🤖 AI/ML","Aggregators","Developer Tools"],"sub_categories":["MCP Servers","How to Submit"],"readme":"# MCP Tool Kit\n\nA comprehensive toolkit for the Model Context Protocol (MCP) with automatic tool discovery and multiple transport options.\n\n[![PyPI version](https://img.shields.io/pypi/v/mcptoolkit.svg)](https://pypi.org/project/mcptoolkit/)\n[![Python versions](https://img.shields.io/pypi/pyversions/mcptoolkit.svg)](https://pypi.org/project/mcptoolkit/)\n[![License](https://img.shields.io/github/license/getfounded/mcp-tool-kit.svg)](https://github.com/getfounded/mcp-tool-kit/blob/main/LICENSE)\n\n📚 **[Official Documentation](https://docs.mcp-tool-kit.com)** | 🌐 **[Website](https://mcp-tool-kit.com)** | 💬 **[Community](https://github.com/getfounded/mcp-tool-kit/discussions)**\n\n---\n\n🚀 **Built by [UsefulAI](https://usefulai.ai)** | 📖 **[From GitHub to Commercial Success](https://usefulai.ai/blog/articles/from-github-to-commercial-success)**\n\n## 🚀 Quick Install - No Git Required!\n\nChoose your platform and run ONE command:\n\n### 🖥️ Windows (PowerShell)\n```powershell\nirm https://raw.githubusercontent.com/getfounded/mcp-tool-kit/main/install.ps1 | iex\n```\n\n### 🍎 macOS (Terminal)\n```bash\nbash \u003c(curl -s https://raw.githubusercontent.com/getfounded/mcp-tool-kit/main/install.sh)\n```\n\n### 🐧 Linux (Terminal)\n```bash\nbash \u003c(wget -qO- https://raw.githubusercontent.com/getfounded/mcp-tool-kit/main/install.sh)\n```\n\n**That's it!** The installer will:\n- ✅ Download MCP Tool Kit (no Git needed!)\n- ✅ Check for Docker (helps install if missing)\n- ✅ Create desktop shortcuts\n- ✅ Set up everything automatically\n\n## 📦 Alternative Installation Methods\n\n\u003cdetails\u003e\n\u003csummary\u003eManual Download\u003c/summary\u003e\n\n1. Download the latest release:\n   - [Windows: MCP-Tool-Kit-Windows.zip](https://github.com/getfounded/mcp-tool-kit/releases/latest)\n   - [Mac/Linux: MCP-Tool-Kit-Unix.tar.gz](https://github.com/getfounded/mcp-tool-kit/releases/latest)\n\n2. Extract and run:\n   - **Windows**: Run `install.bat`\n   - **Mac/Linux**: Run `./install.sh`\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eGit Installation (for developers)\u003c/summary\u003e\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/getfounded/mcp-tool-kit.git\n   cd mcp-tool-kit\n   ```\n\n2. **Run the launcher**\n   - **Windows**: Double-click `launch.bat`\n   - **Mac/Linux**: Run `./launch.sh`\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eDocker-Only Installation\u003c/summary\u003e\n\n```bash\ndocker run -it --name mcp-toolkit ghcr.io/getfounded/mcp-tool-kit:latest\n```\n\u003c/details\u003e\n\n## 🔧 Features\n\n### Dynamic Tool Registration\nTools are automatically discovered and registered at runtime - no manual configuration needed!\n\n### Multiple Transport Options\n- **stdio**: For Claude Desktop integration\n- **SSE (Server-Sent Events)**: For web-based access\n\n### 120+ Available Tools\n- 📁 **File System**: Read, write, and manage files\n- 🕐 **Time Tools**: Timezone conversions and time operations\n- 🌐 **Web Search**: Brave Search integration\n- 🤖 **Browser Automation**: Playwright-based browser control\n- 📊 **Data Analysis**: Yahoo Finance, FRED, World Bank data\n- 📄 **Document Tools**: PDF, Excel, PowerPoint manipulation\n- 🎯 **And many more!**\n\n### Easy Configuration\nControl everything through a simple `config.yaml` file:\n\n```yaml\nenabled_tools:\n  filesystem: true\n  time_tools: true\n  brave_search: true\n  # ... more tools\n\ntool_config:\n  filesystem:\n    allowed_directories: [\"~/Documents\", \"~/Downloads\"]\n  brave_search:\n    max_results: 10\n```\n\n## 📋 Environment Setup\n\n1. Copy `.env.template` to `.env`\n2. Add your API keys:\n   ```env\n   BRAVE_SEARCH_API_KEY=your_key_here\n   NEWS_API_KEY=your_key_here\n   FRED_API_KEY=your_key_here\n   # ... other keys\n   ```\n\n## 💾 Storage Setup\n\nMCP Tool Kit uses a dedicated storage directory for file operations:\n\n- **Windows**: `C:\\Users\\{Username}\\mcp-tool-kit-storage`\n- **Mac/Linux**: `~/mcp-tool-kit-storage`\n\n### Automatic Setup\nThe storage directory is automatically created when you first run the Docker container. You can also manually set it up:\n\n**Windows (PowerShell)**:\n```powershell\n.\\scripts\\setup-storage.ps1\n```\n\n**Mac/Linux**:\n```bash\n./scripts/setup-storage.sh\n```\n\n### Storage Structure\n```\nmcp-tool-kit-storage/\n├── documents/     # For document files\n├── downloads/     # For downloaded files\n└── workspace/     # For temporary work files\n```\n\nAll file operations through the filesystem tool will be restricted to this directory for security.\n\n## 🔌 Connecting to Claude Desktop\n\n1. Start the server in stdio mode using the launcher\n2. Add to Claude Desktop configuration:\n   ```json\n   {\n     \"mcpServers\": {\n       \"mcp-tool-kit\": {\n         \"command\": \"docker\",\n         \"args\": [\"exec\", \"-i\", \"mcp-server\", \"python\", \"mcp_server_v2.py\"]\n       }\n     }\n   }\n   ```\n\n## 🌐 Using SSE Mode\n\n1. Start the server in SSE mode using the launcher\n2. Access the server at `http://localhost:8080`\n3. Use the SSE endpoints:\n   - `/sse` - Server-Sent Events stream\n   - `/messages` - Send messages to the server\n\n## 🛠️ Creating Custom Tools\n\nTools now use a standardized base class system:\n\n```python\nfrom app.tools.base_tool import BaseTool\n\nclass MyCustomTool(BaseTool):\n    def get_name(self) -\u003e str:\n        return \"My Custom Tool\"\n        \n    def get_tools(self) -\u003e Dict[str, Callable]:\n        return {\n            \"my_function\": self.my_function\n        }\n        \n    async def my_function(self, param: str, ctx: Context = None) -\u003e str:\n        return f\"Processed: {param}\"\n```\n\nSee the [developer documentation](https://docs.mcp-tool-kit.com) for detailed guides.\n\n## 📚 Documentation\n\nFull documentation is available at [https://docs.mcp-tool-kit.com](https://docs.mcp-tool-kit.com).\n\nTo run documentation locally:\n1. `cd docs`\n2. `npm install`\n3. `npm start`\n\n## 🐳 Docker Commands\n\n### Using the Launcher (Recommended)\nThe launcher scripts handle all Docker operations automatically.\n\n### Manual Commands\n```bash\n# Start server\ndocker-compose up -d\n\n# View logs\ndocker-compose logs -f\n\n# Stop server\ndocker-compose down\n\n# Rebuild after changes\ndocker-compose build --no-cache\n```\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create your feature branch\n3. Add your tool to `app/tools/`\n4. Submit a pull request\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## 🆘 Support\n\n- [GitHub Issues](https://github.com/getfounded/mcp-tool-kit/issues)\n- [Documentation](https://docs.mcp-tool-kit.com)\n- [Discord Community](#) (coming soon)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetfounded%2Fmcp-tool-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgetfounded%2Fmcp-tool-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetfounded%2Fmcp-tool-kit/lists"}