convez.ai
MCP ServerIntegração & APIsIntermediário
aksivusam-boop

MCP Tools Server

aksivusam-boop/mcp-tools-server

Servidor MCP minimalista e dependency-free para expor tools customizadas

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor Model Context Protocol leve e sem dependências externas que expõe ferramentas customizadas para clientes MCP como Claude Desktop ou Claude CLI. Implementa o protocolo JSON-RPC 2.0 com transporte stdio e permite definir tools em Python puro com apenas o stdlib.

Instalação

$npx convez-ai aksivusam-boop/mcp-tools-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
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Criar ferramentas customizadas para Claude Desktop
  • Integrar lógica Python diretamente com assistentes Claude
  • Construir servidores MCP simples sem overhead de dependências

Veredito

Ferramenta bem projetada para quem quer expor tools Python ao Claude via MCP sem complexidade desnecessária. A abordagem dependency-free e testável é valiosa para casos simples, mas adequa-se melhor a developers que já entendem MCP e protocolos JSON-RPC.

README

A tradução para o português deste README ainda está na fila.

mcp-tools-server

A small, dependency-free Model Context Protocol (MCP) server that exposes tools to MCP clients such as Claude Desktop or the Claude CLI. It implements the JSON-RPC 2.0 handshake (initialize) plus tools/list and tools/call over the newline-delimited stdio transport.

Because it is pure standard library, the request dispatch is a plain function from a request dict to a response dict — easy to read and exhaustively tested.

Define a tool

from mcp_tools_server import MCPServer

server = MCPServer(name="my-tools")

@server.tool(
    name="add",
    description="Add two numbers.",
    input_schema={
        "type": "object",
        "properties": {"a": {"type": "number"}, "b": {"type": "number"}},
        "required": ["a", "b"],
    },
)
def add(args: dict) -> str:
    return str(args["a"] + args["b"])

if __name__ == "__main__":
    server.serve_stdio()

Try it from the shell

The server speaks one JSON object per line. Pipe a couple of requests in:

printf '%s\n%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize"}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"add","arguments":{"a":2,"b":3}}}' \
  | python -m mcp_tools_server

Register with an MCP client

{
  "mcpServers": {
    "tools": { "command": "python", "args": ["-m", "mcp_tools_server"] }
  }
}

Design notes

  • Tool failures are reported in-band via isError: true in the result, matching the MCP spec — a buggy tool never takes down the JSON-RPC channel.
  • Notifications (requests without an id, e.g. notifications/initialized) produce no response.
  • Unknown methods return -32601; unknown tools return -32602.

Tests

python -m unittest discover -s tests -v

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados