MCP Python Server — API Wrapper
MCP Python Server — API Wrapper
Este proyecto crea un servidor MCP en Python que expone una herramienta para consultar una API externa. Compatible con Claude Desktop o ChatGPT Desktop que soporten el Model Context Protocol (MCP).
✨ Características
Exposición de una herramienta (tool) vía MCP
Consulta HTTP a una API externa
Integración directa con Claude/Desktop vía claude.json
Related MCP server: MCP Starter
🚀 Requisitos
Python 3.9+
mcp[cli] (instalable vía pip o uv)
Claude o ChatGPT Desktop (con soporte MCP)
📁 Estructura del proyecto
.
├── servidores/profile.py # Servidor MCP con herramientas para interactuar con mi backend del curriculum.
├── server.py # Servidor MCP con herramienta "consultar_api".
├── .env # Variables opcionales para auth/API.
├── claude.json # Config. MCP para integrarlo directamente.
└── README.md # Este documento.⚙️ Instalación
Con pip
pip install "mcp[cli]"Con uv (recomendado)
uv init mcp-api-server
cd mcp-api-server
uv add "mcp[cli]"Instación del MCP
mcp install mi_script.pyInatalación con .env
mcp install mi_script.py -f .envInstalación de dependencias
pip install -r requirements.txtVariables de entorno
Crea un archivo .env en la raíz del proyecto para definir variables de entorno opcionales:
# .env
API_KEY=mi_api_key
API_URL=https://miapi.com/consulta👷 Rápido Inicio (Quickstart)
Crear el servidor server.py
from mcp.server.fastmcp import FastMCP
import httpx
mcp = FastMCP("API Wrapper")
@mcp.tool(description="Consulta una API externa")
async def consultar_api(param: str) -> str:
"""Consulta una API externa con un parámetro y devuelve la respuesta."""
async with httpx.AsyncClient() as client:
r = await client.get(f"https://miapi.com/consulta?param={param}")
return r.textEjecutar localmente en modo dev
mcp dev server.pyEjecutar en modo producción
mcp run server.pyO con uv:
uv run --with mcp[cli] mcp run server.py🚀 Integración con Claude/Desktop
Ubica claude.json en la carpeta de configuración de Claude/Desktop:
En Windows: %APPDATA%\Claude\claude.json
En Linux/macOS: ~/.claude/claude.json
Ejemplo:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/codigo/backend-curso-inkor/proyectos_memes"
]
},
"Demo": {
"command": "uv",
"args": [
"run",
"--with",
"mcp[cli]",
"mcp",
"run",
"C:\\codigo\\backend-curso-inkor\\MCP\\server.py"
]
}
}
}🤖 Uso dentro de Claude/Desktop
Puedes pedirle al modelo:
Usa la herramienta consultar_api con el parámetro "ping"
Y el modelo usará tu servidor MCP para hacer una llamada HTTP en tiempo real.
🎁 Bonus: extensión de herramientas
@mcp.tool()
async def traducir(texto: str, lang: str) -> str:
return f"Traducido: {texto} → {lang}"🔍 Recursos
Documentación oficial MCP: https://docs.mcp.run/
Repositorio SDK Python: https://github.com/modelcontextprotocol/mcp
✅ Hecho con amor y httpx 🚀
This server cannot be deployed
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
A Model Context Protocol server for Wix AI tools
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA custom Model Context Protocol server that gives Claude Desktop and other LLMs access to file system operations and command execution capabilities through standardized tool interfaces.23Apache 2.0
- AlicenseDqualityDmaintenanceA foundation for building custom local Model Context Protocol (MCP) servers that provide tools accessible to AI assistants like Cursor or Claude Desktop.137MIT
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that allows integration with Claude Desktop by creating and managing custom tools that can be executed through the MCP framework.49 npm-
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server built with the mcp-framework for developing and managing custom tools. It provides a structured foundation for building and integrating modular components like data processors and API clients into Claude Desktop.4 npm-