{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_fs9x8ugaqaer","handle":"mcp-testaserver-http","url":"https://wellknown.network/agents/mcp-testaserver-http","links":{"self":"https://wellknown.network/agents/mcp-testaserver-http/record.json","html":"https://wellknown.network/agents/mcp-testaserver-http","markdown":"https://wellknown.network/agents/mcp-testaserver-http/record.md","api":"https://wellknown.network/api/v1/agents/mcp-testaserver-http","status":"https://wellknown.network/api/v1/agents/mcp-testaserver-http/status","claim":"https://wellknown.network/agents/mcp-testaserver-http/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-testaserver-http/claim.json","badge":"https://wellknown.network/agents/mcp-testaserver-http/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-testaserver-http/history","tools":"https://wellknown.network/api/v1/agents/mcp-testaserver-http/tools"},"ard":{"identifier":"urn:air::server:mcp-testaserver-http","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-testaserver-http","summary":"Un servidor MCP que actúa como puente HTTP","description":"# MCP ↔ HTTP Bridge\n\nServidor MCP local (stdio) que expone dinámicamente las tools de un servidor HTTP externo.\n\n```\nCliente MCP (Claude Code / CLI)\n        ↕  stdio\n  mcp_server.py   ← servidor MCP local\n        ↕  HTTP\n  http_server.py  ← tu backend con las tools\n```\n\n---\n\n## Requisitos\n\n```bash\npip install mcp httpx fastapi uvicorn\n```\n\n---\n\n## Arrancar\n\n### 1. Servidor HTTP (en una terminal)\n\n```bash\npython http_server.py\n# → http://127.0.0.1:8000\n```\n\nPuedes verificar las tools disponibles en:\n```\nGET http://127.0.0.1:8000/tools\n```\n\n### 2. Servidor MCP (lo gestiona el cliente)\n\nEl servidor MCP se lanza automáticamente por el cliente MCP vía stdio.  \nConfigúralo en `~/.claude.json` (Claude Code):\n\n```json\n{\n  \"mcpServers\": {\n    \"http-bridge\": {\n      \"command\": \"python\",\n      \"args\": [\"/ruta/absoluta/a/mcp_server.py\"]\n    }\n  }\n}\n```\n\n---\n\n## Añadir tus propias tools\n\nSolo tienes que modificar `http_server.py`:\n\n1. Añade un dict a la lista `TOOLS` con `name`, `description` e `inputSchema`.\n2. Añade una función `run_mi_tool(args)` con la lógica.\n3. Registra la función en `TOOL_HANDLERS`.\n\nEl servidor MCP las detectará automáticamente sin cambios.\n\n```python\n# Ejemplo en http_server.py\n\nTOOLS.append({\n    \"name\": \"reverse_text\",\n    \"description\": \"Invierte un texto.\",\n    \"inputSchema\": {\n        \"type\": \"object\",\n        \"properties\": {\n            \"text\": {\"type\": \"string\"}\n        },\n        \"required\": [\"text\"]\n    }\n})\n\ndef run_reverse_text(args):\n    return {\"result\": args[\"text\"][::-1]}\n\nTOOL_HANDLERS[\"reverse_text\"] = run_reverse_text\n```\n\n---\n\n## Contrato HTTP\n\n| Método | Ruta              | Descripción                                |\n|--------|-------------------|--------------------------------------------|\n| GET    | `/tools`          | Lista todas las tools disponibles          |\n| POST   | `/tools/{name}`   | Ejecuta la tool `name` con el body JSON    |\n\n**Respuesta de `/tools`:**\n```json\n{\n  \"tools\": [\n    {\n      \"name\": \"calculator\",\n      \"…","publisher":{"name":"A. Campayo","url":null},"homepage":null,"repository":null,"version":"0.1.4","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mcp-testaserver-http","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.779,"provenance":"derived"},{"slug":"productivity.tasks","name":"Tasks & To-do","confidence":0.745,"provenance":"derived"}],"categories":["dev","productivity"],"language":"es"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-testaserver-http","registry":"pypi","observedAt":"2026-09-10T04:24:27.434Z","publishedAt":"2026-03-18T20:43:35.925315Z","latestVersion":"0.1.4"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-testaserver-http","url":"https://pypi.org/project/mcp-testaserver-http/","firstSeenAt":"2026-09-10T04:23:43.470Z","fetchedAt":"2026-09-10T04:23:43.470Z","normalizedAt":"2026-09-10T04:23:43.470Z"}]},"firstSeenAt":"2026-09-10T04:23:43.470Z","updatedAt":"2026-09-10T04:24:27.434Z"}