Skip to content
Back to search

hypertool-mcp

Dynamically expose tools from proxied servers based on an Agent Persona

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/toolprint--hypertool-mcp/badge.svg)](/listings/toolprint--hypertool-mcp)

HTML

<a href="/listings/toolprint--hypertool-mcp"><img src="/api/listings/toolprint--hypertool-mcp/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.

Step 1: Copy Your Existing Config

# In your project directory
cp .mcp.json .mcp.hypertool.json

Step 2: Point Your AI to HyperTool

Replace your `.mcp.json` with:

{
  "mcpServers": {
    "hypertool": {
      "command": "npx",
      "args": ["-y", "@toolprint/hypertool-mcp", "mcp", "run", "--mcp-config", ".mcp.hypertool.json"]
    }
  }
}

Step 3: Create Your First Toolset

Restart your AI and try:

You: "Create a toolset called 'coding' with git and docker tools"
AI: "Created 'coding' toolset with 15 focused tools"

You: "Switch to coding toolset"
AI: "Equipped! I now have just the tools needed for development"

**That's it!** Your AI is now focused and effective. ๐ŸŽ‰

๐Ÿ’ก **Want automated setup?** Try our interactive `setup` command - see [Advanced Guide](guides/ADVANCED.md#setup-command) for details.

๐Ÿ“š **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).

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 ยท 419 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <picture>
  2. <source media="(prefers-color-scheme: dark)" srcset="./assets/hypertool_darkmode_wordmark_horizontal.png">
  3. <source media="(prefers-color-scheme: light)" srcset="./assets/hypertool_lightmode_wordmark_horizontal.png">
  4. <img 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">
  5. </picture>
  6. <h1 align="center">Give your AI the best tools from all your MCPs ๐ŸŽฏ</h1>
  7. [![Version](https://img.shields.io/npm/v/@toolprint/hypertool-mcp)](https://npmjs.com/package/@toolprint/hypertool-mcp)
  8. [![Downloads](https://img.shields.io/npm/dm/@toolprint/hypertool-mcp)](https://npmjs.com/package/@toolprint/hypertool-mcp)
  9. [![Discord](https://img.shields.io/discord/1379961140259459113?logo=discord&logoColor=white&label=Discord&color=5865F2)](https://discord.gg/MbvndnJ45W)
  10. [![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
  11. [![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-green)](https://modelcontextprotocol.io)
  12. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
  13. ## โšก Features
  14. ### ๐Ÿ”“ **Break Free from Tool Limits**
  15. Connect unlimited MCP servers. Use 10, 50, or 500+ tools total - your AI only sees what it needs.
  16. ### ๐ŸŽฏ **Task-Specific Toolsets**
  17. Build "git-essentials" with 5 tools instead of drowning in 47 Git commands. Switch contexts instantly.
  18. ### ๐Ÿง  **Smart Tool Descriptions**
  19. Enhance tools with examples and context. Watch your AI pick the right tool 89% more often.
  20. ## ๐Ÿš€ Quick Start
  21. ### Step 1: Copy Your Existing Config
  22. ```bash
  23. # In your project directory
  24. cp .mcp.json .mcp.hypertool.json
  25. ```
  26. ### Step 2: Point Your AI to HyperTool
  27. Replace your `.mcp.json` with:
  28. ```json
  29. {
  30. "mcpServers": {
  31. "hypertool": {
  32. "command": "npx",
  33. "args": ["-y", "@toolprint/hypertool-mcp", "mcp", "run", "--mcp-config", ".mcp.hypertool.json"]
  34. }
  35. }
  36. }
  37. ```
  38. ### Step 3: Create Your First Toolset
  39. Restart your AI and try:
  40. ```
  41. You: "Create a toolset called 'coding' with git and docker tools"
  42. AI: "Created 'coding' toolset with 15 focused tools"
  43. You: "Switch to coding toolset"
  44. AI: "Equipped! I now have just the tools needed for development"
  45. ```
  46. **That's it!** Your AI is now focused and effective. ๐ŸŽ‰
  47. ๐Ÿ’ก **Want automated setup?** Try our interactive `setup` command - see [Advanced Guide](guides/ADVANCED.md#setup-command) for details.
  48. ๐Ÿ“š **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).
  49. ## ๐ŸŽญ Personas: Pre-configured Tool Bundles (NEW!)
  50. Don't want to configure from scratch? Use personas - ready-to-use MCP server bundles with pre-built toolsets.
  51. ### What are Personas?
  52. Think of personas as "app bundles" for your AI - they come with:
  53. - โœ… Pre-configured MCP servers
  54. - โœ… Curated toolsets for specific workflows
  55. - โœ… Everything you need to get started instantly
  56. ### Quick Start with Personas
  57. ```bash
  58. # 1. Clone the persona collection
  59. git clone https://github.com/toolprint/awesome-mcp-personas
  60. # 2. Add a persona (e.g., web-dev persona)
  61. hypertool-mcp persona add awesome-mcp-personas/personas/web-dev
  62. # 3. Run with the persona
  63. npx -y @toolprint/hypertool-mcp mcp run --persona web-dev
  64. ```
  65. That's it! No server configuration needed. The persona brings its own servers and toolsets.
  66. ๐Ÿ“ฆ **Browse all available personas**: [awesome-mcp-personas](https://github.com/toolprint/awesome-mcp-personas)
  67. ### Available Personas
  68. | Persona | Included Servers | Best For |
  69. |---------|-----------------|----------|
  70. | **web-dev** | Git, Docker, Filesystem, Browser, Testing | Full-stack web development |
  71. | **data-scientist** | Python, Jupyter, Database, Filesystem, Plotting | Data analysis & ML workflows |
  72. | **devops** | Docker, Kubernetes, AWS, Terraform, Monitoring | Infrastructure & deployment |
  73. | **content-creator** | Notion, Slack, Grammar, SEO, Social | Writing & content management |
  74. | **researcher** | Perplexity, Arxiv, Wikipedia, Filesystem | Research & knowledge work |
  75. ### Persona vs Standard Mode
  76. ```bash
  77. # Standard Mode (use your existing MCP servers):
  78. npx -y @toolprint/hypertool-mcp mcp run --mcp-config .mcp.hypertool.json
  79. # Persona Mode (bundled servers + pre-built toolsets):
  80. npx -y @toolprint/hypertool-mcp mcp run --persona web-dev
  81. # Persona Mode with specific toolset:
  82. npx -y @toolprint/hypertool-mcp mcp run --persona web-dev --equip-toolset frontend
  83. ```
  84. ๐Ÿ’ก **Pro tip**: Personas can be mixed with your existing servers! Add `--mcp-config` to include your custom servers alongside the persona's servers.
  85. ๐Ÿ“š **Learn more**: See the complete [Personas Guide](guides/PERSONAS.md) for detailed instructions, creating custom personas, and troubleshooting.
  86. ## ๐Ÿ“Š Context Measurement (NEW!)
  87. See exactly how much context each tool consumes. Optimize your toolsets with token estimates for every tool.
  88. <div align="center">
  89. <img src="./assets/toolset_context.png" alt="Toolset Context View" width="700">
  90. <p><em>Active toolset showing token usage per tool</em></p>
  91. </div>
  92. **Why it matters:**
  93. - ๐ŸŽฏ **Optimize context usage** - Identify heavyweight tools consuming your context window
  94. - ๐Ÿ“‰ **Make informed decisions** - See token costs before adding tools to toolsets
  95. - ๐Ÿ” **Compare alternatives** - Find lighter tools that do the same job
  96. - ๐Ÿ’ก **Budget your context** - Understand exactly what you're exposing to your AI
  97. **How to use:**
  98. Ask your AI to use these MCP tools to see context information:
  99. - `list-available-tools` - Shows token estimates for all available tools
  100. - `get-active-toolset` - Shows token usage for your currently equipped toolset
  101. Each tool displays estimated tokens and percentage of total context consumed. Perfect for building lean, efficient toolsets!
  102. ## ๐ŸŽฌ Demo
  103. ### Hotswap toolsets across 100+ tools
  104. _Targeted toolsets across any number of MCPs. Swap to the best toolset for a goal with a tool call. Dynamic tool registration._
  105. <div align="center">
  106. <a href="https://www.youtube.com/watch?v=43fkKOBayCg">
  107. <img src="./demos/build_dynamic_toolsets_1080p_25fps.gif" alt="HyperTool Demo - Click for full video" width="800">
  108. </a>
  109. </div>
  110. ## ๐Ÿ—๏ธ How It Works
  111. ```
  112. Before: Tool Chaos ๐Ÿ˜ต
  113. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  114. โ”‚ Claude/ โ”‚โ”€โ”€โ–ถโ”‚ 50+ tools from 8 servers โ”‚
  115. โ”‚ Cursor โ”‚ โ”‚ โŒ Wrong picks โ”‚
  116. โ”‚ โ”‚ โ”‚ โŒ Slow decisions โ”‚
  117. โ”‚ โ”‚ โ”‚ โŒ Confused context โ”‚
  118. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  119. After: Expert Mode ๐ŸŽฏ
  120. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  121. โ”‚ Claude/ โ”‚โ”€โ”€โ–ถโ”‚ HyperTool โ”‚โ”€โ”€โ–ถโ”‚ ALL Your Tools โ”‚
  122. โ”‚ Cursor โ”‚ โ”‚ (Local) โ”‚ โ”‚ (Same servers) โ”‚
  123. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  124. โ”‚
  125. โ–ผ
  126. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  127. โ”‚ Smart Toolsets โ”‚
  128. โ”‚ ๐Ÿ”จ coding (5) โ”‚ โ† "I'm coding now"
  129. โ”‚ ๐Ÿ“ writing (3) โ”‚ โ† "I'm writing now"
  130. โ”‚ ๐Ÿ“Š analysis (4) โ”‚ โ† "I'm analyzing now"
  131. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  132. โœ… Expert picks every time
  133. ```
  134. ### What's a "Toolset"? Think Playlists for Your AI
  135. Just like Spotify playlists organize your music, toolsets organize your AI tools:
  136. ```
  137. ALL YOUR TOOLS (64 total) YOUR TOOLSETS
  138. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  139. โ”‚ ๐Ÿณ Docker (19 tools) โ”‚ โ”‚ ๐Ÿ”จ "coding" โ”‚
  140. โ”‚ โ€ข build_image โ”‚ โ”Œโ”€โ”€โ”€โ–ถ โ”‚ โ€ข git.status โ”‚
  141. โ”‚ โ€ข create_container โ”‚ โ”‚ โ”‚ โ€ข git.commit โ”‚
  142. โ”‚ โ€ข run_container โ”‚ โ”‚ โ”‚ โ€ข docker.build โ”‚
  143. โ”‚ โ€ข stop_container โ”‚ โ”‚ โ”‚ โ€ข docker.run โ”‚
  144. โ”‚ โ€ข [... 15 more] โ”‚ โ”‚ โ”‚ โ€ข github.pr โ”‚
  145. โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  146. โ”‚ ๐Ÿ”€ Git (12 tools) โ”‚โ”€โ”€โ”€โ”ค
  147. โ”‚ โ€ข status โ”‚ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  148. โ”‚ โ€ข commit โ”‚ โ”‚ โ”‚ ๐Ÿ“ "writing" โ”‚
  149. โ”‚ โ€ข push โ”‚ โ””โ”€โ”€โ”€โ–ถ โ”‚ โ€ข notion.create โ”‚
  150. โ”‚ โ€ข [... 9 more] โ”‚ โ”‚ โ€ข slack.send โ”‚
  151. โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค โ”‚ โ€ข grammarly.fix โ”‚
  152. โ”‚ ๐Ÿ“ Notion (8 tools) โ”‚โ”€โ”€โ”€โ”€โ”€โ” โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  153. โ”‚ ๐Ÿ’ฌ Slack (6 tools) โ”‚ โ”‚
  154. โ”‚ ๐Ÿ“Š Linear (10 tools) โ”‚ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  155. โ”‚ ๐Ÿงช Testing (9 tools) โ”‚ โ””โ”€โ–ถ โ”‚ ๐Ÿ› "debugging" โ”‚
  156. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ€ข logs.search โ”‚
  157. โ”‚ โ€ข docker.logs โ”‚
  158. AI sees ALL 64 tools = confused ๐Ÿ˜ต โ”‚ โ€ข traces.view โ”‚
  159. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  160. AI sees 3-5 tools = focused ๐ŸŽฏ
  161. ```
  162. ## ๐Ÿ’ผ Real-World Toolsets
  163. Create focused toolsets for different workflows:
  164. ### ๐Ÿ”จ Development Mode
  165. ```
  166. "deep-coding": git + docker + filesystem (12 tools)
  167. โ†’ Everything you need for feature development
  168. "code-review": git + github + linear (10 tools)
  169. โ†’ Review PRs, update tickets, merge with confidence
  170. "debugging": logs + docker + traces + alerts (8 tools)
  171. โ†’ Find and fix issues fast
  172. ```
  173. ### ๐Ÿ“ Content Creation
  174. ```
  175. "writing": notion + grammarly + slack (6 tools)
  176. โ†’ Blog posts, docs, and team updates
  177. "research": perplexity + notion + filesystem (7 tools)
  178. โ†’ Deep dives with organized notes
  179. ```
  180. ### ๐ŸŽฌ Real Chat Example
  181. ```
  182. You: "I need to debug our API"
  183. AI: "I'll switch to the debugging toolset for better focus"
  184. [Now has: logs, traces, curl, docker]
  185. You: "Actually, let's write the incident report"
  186. AI: "Switching to writing toolset"
  187. [Now has: notion, slack, templates]
  188. ```
  189. ๐Ÿ’ก **Pro tip**: Start with 3-5 tools per toolset. Your AI will thank you!
  190. ## ๐Ÿ“‹ All Features
  191. Explore everything HyperTool can do:
  192. | Feature | Description | Guide |
  193. |---------|-------------|-------|
  194. | **๐ŸŽญ Personas** | Pre-configured MCP server bundles with curated toolsets. Get started instantly with ready-to-use workflows for web-dev, data science, DevOps, and more. | [Personas Guide](guides/PERSONAS.md) |
  195. | **๐Ÿ“ Server Groups** | Organize MCP servers into logical groups. Launch related servers together, switch between projects, and maintain focused contexts. | [Advanced Guide](guides/ADVANCED.md) |
  196. | **๐Ÿ“Š Context Measurement** | See token estimates for every tool. Optimize your toolsets by understanding exactly how much context each tool consumes. | [Context Measurement](docs/features/context-measurement.md) |
  197. | **๐Ÿ”ง Configuration Mode** | Smart separation of toolset management from operational tools. Keep your AI focused on work, not configuration. | [Configuration Mode Guide](guides/CONFIGURATION_MODE.md) |
  198. | **๐ŸŽฏ Dynamic Toolsets** | Build, modify, and switch between toolsets on the fly. Adapt your AI's capabilities to match your current task. | [Examples & Recipes](guides/EXAMPLES.md) |
  199. | **๐Ÿง  Tool Annotations** | Enhance tools with custom descriptions, examples, and context. Improve your AI's tool selection accuracy by 89%. | [Advanced Guide](guides/ADVANCED.md) |
  200. | **๐Ÿš€ HTTP Mode** | Run HyperTool as a long-lived HTTP server for persistent connections and faster response times. | [Advanced Guide](guides/ADVANCED.md) |
  201. | **๐Ÿ”Œ Unlimited Servers** | Connect as many MCP servers as you need. Break free from the 100-tool limit without sacrificing performance. | [Quick Start](#-quick-start) |
  202. ## โ“ FAQ
  203. ### General Questions
  204. **Q: How is this different from just using MCP servers directly?**
  205. A: HyperTool lets you use unlimited MCP servers without hitting the 100-tool limit, and dynamically switches between focused toolsets for better AI performance.
  206. **Q: What's the difference between Personas and Standard Mode?**
  207. A: Standard Mode uses your existing MCP server configurations. Personas are pre-packaged bundles that include both MCP servers AND curated toolsets - perfect for getting started quickly or trying new workflows.
  208. **Q: Can I use multiple toolsets at once?**
  209. A: In stdio mode (default), use `--equip-toolset <name>` when launching. HTTP mode supports one active toolset but you can switch anytime.
  210. **Q: Where are my toolsets and configurations stored?**
  211. A: Everything is stored locally in `~/.toolprint/hypertool-mcp/`:
  212. - Personas: `~/.toolprint/hypertool-mcp/personas/`
  213. - Toolsets: `~/.toolprint/hypertool-mcp/toolsets/`
  214. - Preferences: `~/.toolprint/hypertool-mcp/config/`
  215. You can directly edit these files when HyperTool is not running.
  216. ### Setup & Compatibility
  217. **Q: Does this work with Claude Desktop / Cursor / Claude Code?**
  218. A: 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).
  219. **Q: What if an MCP server goes down?**
  220. A: HyperTool monitors health and automatically reconnects when servers come back. Your toolsets stay intact.
  221. **Q: Can I share toolsets with my team?**
  222. A: 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.
  223. **Q: How accurate are the token estimates in context measurement?**
  224. A: The estimates use BPE-based approximation for consistent relative comparisons between tools. They're perfect for understanding which tools consume more context, but not exact counts since different LLMs use different tokenizers.
  225. **Q: Does context measurement slow down my toolsets?**
  226. A: No! Token counts are cached and add less than 10ms overhead. You won't notice any performance impact.
  227. ### Technical Questions
  228. **Q: How do I add tools from a new MCP server?**
  229. A: Just add the server to your `.mcp.hypertool.json` config. It's automatically available for toolsets.
  230. **Q: Can I use this in production?**
  231. A: Yes! For enterprise support, [contact us](mailto:support@onegrep.dev?subject=HyperTool%20Production%20Use&body=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!).
  232. ## ๐ŸŽฎ App Compatibility
  233. **Works with ANY MCP-compatible app!** HyperTool is a standard MCP server, so if your app supports MCP, it supports HyperTool.
  234. ### Hot-swap Toolsets Without Restarts
  235. | App | Status | How to Switch Toolsets |
  236. |-----|---------|------------------------|
  237. | **Cursor/VSCode** | โœ… Full support | Switch toolsets instantly - no restart needed! |
  238. | **Claude Code** | โณ Coming soon | Use `--equip-toolset <name>` flag ([track progress](https://github.com/anthropics/claude-code/issues/4118)) |
  239. | **Claude Desktop** | โณ In progress | Restart app after switching toolsets |
  240. ---
  241. ๐Ÿ“š **Learn More**
  242. - ๐ŸŽญ [Personas Guide](guides/PERSONAS.md) - Complete guide to using and creating personas
  243. - ๐Ÿ”ฌ [Research & Performance](guides/RESEARCH.md) - Why focused toolsets work
  244. - ๐Ÿš€ [Advanced Features](guides/ADVANCED.md) - Tool annotations, HTTP mode, CLI
  245. - ๐Ÿ”ง [Troubleshooting](guides/TROUBLESHOOTING.md) - Common issues and solutions
  246. - ๐Ÿ“– [Examples & Recipes](guides/EXAMPLES.md) - Toolset patterns for every workflow
  247. ## ๐Ÿ› ๏ธ Development Setup
  248. ### Prerequisites
  249. - Node.js 18+
  250. - Python 3.8+ (for pre-commit hooks)
  251. ### Quick Setup
  252. ```bash
  253. # Clone and install
  254. git clone https://github.com/toolprint/hypertool-mcp.git
  255. cd hypertool-mcp
  256. just setup-dev # Installs dependencies and pre-commit hooks
  257. ```
  258. ### Pre-commit Hooks
  259. This project uses pre-commit hooks to ensure code quality:
  260. ```bash
  261. # Install pre-commit hooks (included in setup-dev)
  262. just setup-pre-commit
  263. # Run hooks manually
  264. just pre-commit-check # On staged files
  265. just pre-commit-check-all # On all files
  266. # Skip hooks for emergency commits (use sparingly)
  267. SKIP=eslint,typescript git commit -m "emergency fix"
  268. ```
  269. ### Available Commands
  270. ```bash
  271. just build # Build the project
  272. just test # Run tests
  273. just lint # Run linting
  274. just format # Format code
  275. just typecheck # Check types
  276. just pre-publish-checks # Run all quality checks
  277. ```
  278. ### Service command
  279. The `hypertool-mcp service` subcommand is currently disabled and will exit with a
  280. notification when invoked.
  281. ## ๐Ÿค Contributing
  282. Found a bug? Have an idea? We'd love your help!
  283. - ๐Ÿ› [Report issues](https://github.com/toolprint/hypertool-mcp/issues)
  284. - ๐Ÿ’ก [Share ideas](https://github.com/toolprint/hypertool-mcp/discussions)
  285. - ๐Ÿ”ง [Submit PRs](https://github.com/toolprint/hypertool-mcp/pulls)
  286. ## ๐Ÿ“„ License
  287. MIT License - see [LICENSE](LICENSE) file for details.
  288. ---
  289. <div align="center">
  290. **Built by developers who got tired of watching AI pick the wrong tools** ๐ŸŽฏ
  291. <a href="https://toolprint.ai">
  292. <img src="./assets/toolprint.png" alt="Toolprint" width="200">
  293. </a>
  294. <p>
  295. <strong>Built with โค๏ธ by <a href="https://toolprint.ai">Toolprint</a></strong><br>
  296. <sub>ยฉ 2025 OneGrep, Inc.</sub>
  297. </p>
  298. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If itโ€™s helped, pass it on.