MCP Tools Server
aksivusam-boop/mcp-tools-server
Servidor MCP minimalista e dependency-free para expor tools customizadas
Ver no GitHubServidor 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-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
- 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: truein 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.