{"id":30658748,"url":"https://github.com/toolprint/hypertool-mcp","last_synced_at":"2025-08-31T12:04:49.011Z","repository":{"id":305995263,"uuid":"1019203263","full_name":"toolprint/hypertool-mcp","owner":"toolprint","description":"An MCP server that helps you dynamically select tools to expose from servers in your mcp.json","archived":false,"fork":false,"pushed_at":"2025-08-23T20:46:11.000Z","size":64781,"stargazers_count":60,"open_issues_count":1,"forks_count":5,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-24T08:32:36.968Z","etag":null,"topics":["agents","claude-code","hypertool","hypertool-mcp","llms","mcp","mcp-clients","mcp-server","model-context-protocol","tool-binding","tool-selection","toolprint"],"latest_commit_sha":null,"homepage":"https://toolprint.ai","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/toolprint.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-14T00:47:36.000Z","updated_at":"2025-08-24T07:59:37.000Z","dependencies_parsed_at":"2025-07-23T05:14:23.747Z","dependency_job_id":"95210efc-f3fb-4719-9066-50e0aaa3b4dd","html_url":"https://github.com/toolprint/hypertool-mcp","commit_stats":null,"previous_names":["toolprint/hypertool-mcp"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/toolprint/hypertool-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toolprint%2Fhypertool-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toolprint%2Fhypertool-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toolprint%2Fhypertool-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toolprint%2Fhypertool-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/toolprint","download_url":"https://codeload.github.com/toolprint/hypertool-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toolprint%2Fhypertool-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272976998,"owners_count":25025043,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-31T02:00:09.071Z","response_time":79,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["agents","claude-code","hypertool","hypertool-mcp","llms","mcp","mcp-clients","mcp-server","model-context-protocol","tool-binding","tool-selection","toolprint"],"created_at":"2025-08-31T12:01:54.237Z","updated_at":"2025-08-31T12:04:48.982Z","avatar_url":"https://github.com/toolprint.png","language":"TypeScript","funding_links":[],"categories":["Aggregators \u0026 Gateways","📦 Other","📚 Projects (2474 total)"],"sub_categories":["Gateways \u0026 Proxies","MCP Servers"],"readme":"\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"./assets/hypertool_darkmode_wordmark_horizontal.png\"\u003e\n  \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"./assets/hypertool_lightmode_wordmark_horizontal.png\"\u003e\n  \u003cimg alt=\"Shows a darkmode hypertool-mcp Logo in light color mode and a white one in dark color mode.\" src=\"./assets/hypertool_lightmode_wordmark_horizontal.png\"  width=\"full\"\u003e\n\u003c/picture\u003e\n\n\u003ch1 align=\"center\"\u003eGive your AI the best tools from all your MCPs 🎯\u003c/h1\u003e\n\n\n[![Version](https://img.shields.io/npm/v/@toolprint/hypertool-mcp)](https://npmjs.com/package/@toolprint/hypertool-mcp)\n[![Downloads](https://img.shields.io/npm/dm/@toolprint/hypertool-mcp)](https://npmjs.com/package/@toolprint/hypertool-mcp)\n[![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?logo=typescript\u0026logoColor=white)](https://www.typescriptlang.org/)\n[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-green)](https://modelcontextprotocol.io)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n\n\n## ⚡ Features\n\n### 🔓 **Break Free from Tool Limits**\nConnect unlimited MCP servers. Use 10, 50, or 500+ tools total - your AI only sees what it needs.\n\n### 🎯 **Task-Specific Toolsets**\nBuild \"git-essentials\" with 5 tools instead of drowning in 47 Git commands. Switch contexts instantly.\n\n### 🧠 **Smart Tool Descriptions**\nEnhance tools with examples and context. Watch your AI pick the right tool 89% more often.\n\n## 🚀 Quick Start\n\n### Step 1: Copy Your Existing Config\n```bash\n# In your project directory\ncp .mcp.json .mcp.hypertool.json\n```\n\n### Step 2: Point Your AI to HyperTool\nReplace your `.mcp.json` with:\n```json\n{\n  \"mcpServers\": {\n    \"hypertool\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@toolprint/hypertool-mcp\", \"--mcp-config\", \".mcp.hypertool.json\"]\n    }\n  }\n}\n```\n\n### Step 3: Create Your First Toolset\nRestart your AI and try:\n```\nYou: \"Create a toolset called 'coding' with git and docker tools\"\nAI: \"Created 'coding' toolset with 15 focused tools\"\n\nYou: \"Switch to coding toolset\"\nAI: \"Equipped! I now have just the tools needed for development\"\n```\n\n**That's it!** Your AI is now focused and effective. 🎉\n\n💡 **Want automated setup?** Try our interactive `setup` command - see [Advanced Guide](guides/ADVANCED.md#setup-command) for details.\n\n📚 **Configuration Mode:** HyperTool uses a smart Configuration Mode to keep toolset management separate from your operational tools. Learn more in the [Configuration Mode Guide](guides/CONFIGURATION_MODE.md).\n\n## 🎬 Demo\n\n### Hotswap toolsets across 100+ tools\n_Targeted toolsets across any number of MCPs. Swap to the best toolset for a goal with a tool call. Dynamic tool registration._\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://www.youtube.com/watch?v=43fkKOBayCg\"\u003e\n    \u003cimg src=\"./demos/build_dynamic_toolsets_1080p_25fps.gif\" alt=\"HyperTool Demo - Click for full video\" width=\"800\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n## 🏗️ How It Works\n\n```\nBefore: Tool Chaos 😵\n┌─────────────┐   ┌─────────────────────────────┐\n│ Claude/     │──▶│ 50+ tools from 8 servers   │\n│ Cursor      │   │ ❌ Wrong picks             │\n│             │   │ ❌ Slow decisions          │\n│             │   │ ❌ Confused context        │\n└─────────────┘   └─────────────────────────────┘\n\nAfter: Expert Mode 🎯\n┌─────────────┐   ┌──────────────┐   ┌─────────────────┐\n│ Claude/     │──▶│ HyperTool    │──▶│ ALL Your Tools  │\n│ Cursor      │   │ (Local)      │   │ (Same servers)  │\n└─────────────┘   └──────────────┘   └─────────────────┘\n                         │\n                         ▼\n                  ┌─────────────────┐\n                  │ Smart Toolsets  │\n                  │ 🔨 coding (5)   │ ← \"I'm coding now\"\n                  │ 📝 writing (3)  │ ← \"I'm writing now\"\n                  │ 📊 analysis (4) │ ← \"I'm analyzing now\"\n                  └─────────────────┘\n                  ✅ Expert picks every time\n```\n\n### What's a \"Toolset\"? Think Playlists for Your AI\n\nJust like Spotify playlists organize your music, toolsets organize your AI tools:\n\n```\nALL YOUR TOOLS (64 total)              YOUR TOOLSETS\n┌────────────────────────────┐         ┌──────────────────┐\n│ 🐳 Docker (19 tools)       │         │ 🔨 \"coding\"      │\n│  • build_image             │   ┌───▶ │  • git.status    │\n│  • create_container        │   │     │  • git.commit    │\n│  • run_container           │   │     │  • docker.build  │\n│  • stop_container          │   │     │  • docker.run    │\n│  • [... 15 more]           │   │     │  • github.pr     │\n├────────────────────────────┤   │     └──────────────────┘\n│ 🔀 Git (12 tools)          │───┤\n│  • status                  │   │     ┌──────────────────┐\n│  • commit                  │   │     │ 📝 \"writing\"     │\n│  • push                    │   └───▶ │  • notion.create │\n│  • [... 9 more]            │         │  • slack.send    │\n├────────────────────────────┤         │  • grammarly.fix │\n│ 📝 Notion (8 tools)        │─────┐   └──────────────────┘\n│ 💬 Slack (6 tools)         │     │\n│ 📊 Linear (10 tools)       │     │   ┌──────────────────┐\n│ 🧪 Testing (9 tools)       │     └─▶ │ 🐛 \"debugging\"   │\n└────────────────────────────┘         │  • logs.search   │\n                                       │  • docker.logs   │\nAI sees ALL 64 tools = confused 😵     │  • traces.view   │\n                                       └──────────────────┘\n\n                                       AI sees 3-5 tools = focused 🎯\n```\n\n## 💼 Real-World Toolsets\n\nCreate focused toolsets for different workflows:\n\n\n\n### 🔨 Development Mode\n```\n\"deep-coding\": git + docker + filesystem (12 tools)\n→ Everything you need for feature development\n\n\"code-review\": git + github + linear (10 tools)\n→ Review PRs, update tickets, merge with confidence\n\n\"debugging\": logs + docker + traces + alerts (8 tools)\n→ Find and fix issues fast\n```\n\n### 📝 Content Creation\n```\n\"writing\": notion + grammarly + slack (6 tools)\n→ Blog posts, docs, and team updates\n\n\"research\": perplexity + notion + filesystem (7 tools)\n→ Deep dives with organized notes\n```\n\n### 📁 Server Groups (NEW!)\n\nOrganize your MCP servers into logical groups for easy management:\n\n```bash\n# Create a development group\nhypertool-mcp mcp group create development -d \"All development servers\"\n\n# Add servers to the group\nhypertool-mcp mcp group add development git-server docker-server filesystem-server\n\n# Run with a specific group\nhypertool-mcp --group development\n\n# List all groups\nhypertool-mcp mcp group list\n\n# Show servers in a group\nhypertool-mcp mcp group show development\n```\n\nServer groups make it easy to:\n- 🚀 Launch related servers together\n- 📊 Organize servers by project or environment\n- 🔄 Switch between different server configurations\n- 🎯 Maintain focused tool contexts\n\n### 🎬 Real Chat Example\n```\nYou: \"I need to debug our API\"\nAI: \"I'll switch to the debugging toolset for better focus\"\n[Now has: logs, traces, curl, docker]\n\nYou: \"Actually, let's write the incident report\"\nAI: \"Switching to writing toolset\"\n[Now has: notion, slack, templates]\n```\n\n💡 **Pro tip**: Start with 3-5 tools per toolset. Your AI will thank you!\n\n## ❓ FAQ\n\n### General Questions\n\n**Q: How is this different from just using MCP servers directly?**\nA: HyperTool lets you use unlimited MCP servers without hitting the 100-tool limit, and dynamically switches between focused toolsets for better AI performance.\n\n**Q: Can I use multiple toolsets at once?**\nA: In stdio mode (default), use `--equip-toolset \u003cname\u003e` when launching. HTTP mode supports one active toolset but you can switch anytime.\n\n**Q: Where are my toolsets stored?**\nA: Locally in `~/.toolprint/hypertool-mcp/`. Explore the directory to see your configurations.\n\n### Setup \u0026 Compatibility\n\n**Q: Does this work with Claude Desktop / Cursor / Claude Code?**\nA: Yes! Cursor has full hot-swapping support. Claude Desktop works with restart. Claude Code [hot-swap coming soon](https://github.com/anthropics/claude-code/issues/411).\n\n**Q: What if an MCP server goes down?**\nA: HyperTool monitors health and automatically reconnects when servers come back. Your toolsets stay intact.\n\n**Q: Can I share toolsets with my team?**\nA: Import/export is coming soon! For now, you can copy and share toolset files - they'll work if your team has the same MCP servers configured.\n\n### Technical Questions\n\n**Q: How do I add tools from a new MCP server?**\nA: Just add the server to your `.mcp.hypertool.json` config. It's automatically available for toolsets.\n\n**Q: Can I use this in production?**\nA: Yes! For enterprise support, [contact us](mailto:support@onegrep.dev?subject=HyperTool%20Production%20Use\u0026body=Hi%20team%2C%0A%0AI'm%20interested%20in%20using%20HyperTool%20in%20production.%0A%0ACompany%3A%20%0AUse%20case%3A%20%0AScale%3A%20%0A%0AThanks!).\n\n\n## 🎮 App Compatibility\n\n**Works with ANY MCP-compatible app!** HyperTool is a standard MCP server, so if your app supports MCP, it supports HyperTool.\n\n### Hot-swap Toolsets Without Restarts\n\n| App | Status | How to Switch Toolsets |\n|-----|---------|------------------------|\n| **Cursor/VSCode** | ✅ Full support | Switch toolsets instantly - no restart needed! |\n| **Claude Code** | ⏳ Coming soon | Use `--equip-toolset \u003cname\u003e` flag ([track progress](https://github.com/anthropics/claude-code/issues/4118)) |\n| **Claude Desktop** | ⏳ In progress | Restart app after switching toolsets |\n\n---\n\n📚 **Learn More**\n- 🔬 [Research \u0026 Performance](guides/RESEARCH.md) - Why focused toolsets work\n- 🚀 [Advanced Features](guides/ADVANCED.md) - Tool annotations, HTTP mode, CLI\n- 🔧 [Troubleshooting](guides/TROUBLESHOOTING.md) - Common issues and solutions\n- 📖 [Examples \u0026 Recipes](guides/EXAMPLES.md) - Toolset patterns for every workflow\n\n## 🛠️ Development Setup\n\n### Prerequisites\n- Node.js 18+\n- Python 3.8+ (for pre-commit hooks)\n\n### Quick Setup\n```bash\n# Clone and install\ngit clone https://github.com/toolprint/hypertool-mcp.git\ncd hypertool-mcp\njust setup-dev  # Installs dependencies and pre-commit hooks\n```\n\n### Pre-commit Hooks\nThis project uses pre-commit hooks to ensure code quality:\n\n```bash\n# Install pre-commit hooks (included in setup-dev)\njust setup-pre-commit\n\n# Run hooks manually\njust pre-commit-check        # On staged files\njust pre-commit-check-all    # On all files\n\n# Skip hooks for emergency commits (use sparingly)\nSKIP=eslint,typescript git commit -m \"emergency fix\"\n```\n\n### Available Commands\n```bash\njust build          # Build the project\njust test           # Run tests\njust lint           # Run linting\njust format         # Format code\njust typecheck      # Check types\njust pre-publish-checks  # Run all quality checks\n```\n\n### Service command\n\nThe `hypertool-mcp service` subcommand is currently disabled and will exit with a\nnotification when invoked.\n\n## 🤝 Contributing\n\nFound a bug? Have an idea? We'd love your help!\n\n- 🐛 [Report issues](https://github.com/toolprint/hypertool-mcp/issues)\n- 💡 [Share ideas](https://github.com/toolprint/hypertool-mcp/discussions)\n- 🔧 [Submit PRs](https://github.com/toolprint/hypertool-mcp/pulls)\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Built by developers who got tired of watching AI pick the wrong tools** 🎯\n\n\u003ca href=\"https://toolprint.ai\"\u003e\n  \u003cimg src=\"./assets/toolprint.png\" alt=\"Toolprint\" width=\"200\"\u003e\n\u003c/a\u003e\n\n\u003cp\u003e\n  \u003cstrong\u003eBuilt with ❤️ by \u003ca href=\"https://toolprint.ai\"\u003eToolprint\u003c/a\u003e\u003c/strong\u003e\u003cbr\u003e\n  \u003csub\u003e© 2025 OneGrep, Inc.\u003c/sub\u003e\n\u003c/p\u003e\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoolprint%2Fhypertool-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftoolprint%2Fhypertool-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoolprint%2Fhypertool-mcp/lists"}