convez.ai
MCP ServerIntegração & APIsIntermediário
ninjacazul

Hono MCP Server

ninjacazul/hono-mcp-server

Converta endpoints Hono em ferramentas MCP com validação de tipos

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor 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-server

1 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

Estrelas
2
Forks
2
Acompanhando
1
Saúde
42%
Último commit
há 1 mês
Versão
—
Issues abertas
1
Contribuidores
2

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 hono-mcp-server

📥 Download & Install

  1. Visit the Releases page.
  2. Look for the latest release. You will see a list of available files.
  3. Download the file suitable for your operating system.
  4. Once the file is downloaded, locate it in your downloads folder.
  5. 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:

🛠️ 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:

  1. 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";
    
  2. 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 });
        },
      );
    
  3. 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:

📧 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

Download hono-mcp-server again to ensure that you have the latest version. Enjoy building your APIs!

Ver o original no GitHub

Bom para

Relacionados