Hono API
Exposes Hono API endpoints as Model Context Protocol tools, allowing LLMs to interact with your API routes through a dedicated MCP endpoint. It provides helpers to describe routes and includes a codemode for dynamic API interaction via search and exe
What is Hono API?
Hono API is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to exposes hono api endpoints as model context protocol tools, allowing llms to interact with your api routes through a dedicated mcp endpoint. it provides helpers to describe routes and includes a codem...
Exposes Hono API endpoints as Model Context Protocol tools, allowing LLMs to interact with your API routes through a dedicated MCP endpoint. It provides helpers to describe routes and includes a codemode for dynamic API interaction via search and exe
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Exposes Hono API endpoints as Model Context Protocol tools,
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx hono-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Hono API
hono-mcp-server is a TypeScript library that turns your Hono web framework routes into Model Context Protocol tools, allowing AI assistants to call your API endpoints directly via an MCP-compatible client. Instead of building a separate integration layer, you register each Hono route with a description and Zod-validated input/output schemas and the library automatically exposes them at an `/mcp` endpoint. It also supports a 'codemode' that provides generic `search` and `execute` tools for dynamic, documentation-free API interaction without pre-registering individual routes.
Prerequisites
- Node.js 18 or higher installed
- A Hono web application project already set up
- An MCP-compatible client such as Claude Desktop or Cursor
- Basic familiarity with TypeScript and Zod for schema definitions
Install the package
Add hono-mcp-server to your existing Hono project. This package wraps your Hono app and exposes your routes as MCP tools.
npm install hono-mcp-serverRegister the MCP middleware on your Hono app
Import `mcp` from hono-mcp-server and call it with your app's name and version. This attaches the MCP endpoint (default: `/mcp`) to your existing Hono app.
import { Hono } from 'hono';
import { mcp, registerTool } from 'hono-mcp-server';
import { z } from 'zod';
const app = new Hono();
mcp(app, {
name: 'my-api',
version: '1.0.0',
description: 'My Hono API exposed as MCP tools'
});Annotate routes with registerTool
Wrap each route handler with `registerTool` to give the AI a description and typed input schema. Zod schemas are used for validation and are forwarded to the MCP client as tool parameter definitions.
app.post('/search', registerTool({
description: 'Search for items by keyword',
inputSchema: {
query: z.string().describe('The search keyword'),
limit: z.number().optional().describe('Maximum number of results')
}
}), async (c) => {
const { query, limit } = c.req.valid('json');
const results = await db.search(query, limit ?? 10);
return c.json({ results });
});Start your Hono server
Run your Hono application as normal. The MCP endpoint will be available at `/mcp` alongside your existing API routes.
npx tsx src/index.ts
# Or with your preferred runtime:
# bun src/index.tsConfigure your MCP client to connect
Point your MCP client to the running server's MCP endpoint. For HTTP-based MCP clients, supply the full URL. For stdio-based clients like Claude Desktop, use an HTTP bridge or proxy.
Hono API Examples
Client configuration (HTTP MCP endpoint)
Configure Claude Desktop or another MCP client to connect to your running Hono server's /mcp endpoint. Replace the URL with your server's actual host and port.
{
"mcpServers": {
"hono-api": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:3000/mcp"]
}
}
}Prompts to try
Once connected, ask the AI to call your registered API routes by describing what you want in natural language.
- "Search for 'typescript tutorials' and return the top 5 results"
- "What tools does this API expose?"
- "Call the /search endpoint with query='hono' and limit=3"
- "Use codemode to explore what endpoints are available on this API"Troubleshooting Hono API
MCP client cannot connect to the /mcp endpoint
Ensure your Hono server is running and accessible at the configured host/port. If using Claude Desktop (stdio-only), use a tool like `mcp-remote` to bridge the HTTP MCP endpoint to stdio.
Tool input validation errors when calling routes
Make sure the Zod schemas passed to `registerTool` exactly match what the route expects. Input mismatches cause validation failures; check that optional fields use `.optional()` and types are correct.
Routes not appearing as tools in the MCP client
Only routes decorated with `registerTool` are exposed as MCP tools. Ensure `mcp(app, {...})` is called before route definitions and that each target route uses the `registerTool` wrapper.
Frequently Asked Questions about Hono API
What is Hono API?
Hono API is a Model Context Protocol (MCP) server that exposes hono api endpoints as model context protocol tools, allowing llms to interact with your api routes through a dedicated mcp endpoint. it provides helpers to describe routes and includes a codemode for dynamic api interaction via search and exe It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Hono API?
Follow the installation instructions on the Hono API GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Hono API?
Hono API works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Hono API free to use?
Yes, Hono API is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Hono API Alternatives — Similar Developer Tools Servers
Looking for alternatives to Hono API? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Hono API in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Hono API?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.