Servidor MCP Simple (Puente HTTP)

Este es un servidor MCP (Model Context Protocol) simplificado que expone herramientas a través de una interfaz HTTP POST. Permite que LLMs y agentes remotos accedan a funcionalidades locales o específicas de forma segura a través de un túnel o acceso directo.

🚀 Configuraciones Técnicas

• Puerto: 3030

• Endpoint: /mcp

• Método: POST

• Autenticación: Authorization: Bearer senha-facil-123

• Protocolo: JSON-RPC 2.0 (Adaptado para HTTP)

Related MCP server: local-env-mcp

🧪 Probando Remotamente con CURL

Puedes validar el funcionamiento del servidor desde cualquier máquina con acceso a la red (o vía VPN Wireguard) usando los comandos a continuación.

1. Listar Herramientas Disponibles

curl -X POST http://10.7.0.1:3030/mcp \
  -H "Authorization: Bearer senha-facil-123" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

2. Llamar a la Herramienta 'hello'

curl -X POST http://10.7.0.1:3030/mcp \
  -H "Authorization: Bearer senha-facil-123" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"hello","arguments":{"name":"Fabão"}},"id":2}'

♊ Configurando Gemini-CLI (Remoto)

Para que el gemini-cli en tu máquina local u otra VPS acceda a este servidor, debes configurarlo en el archivo de configuración del Gemini CLI (generalmente en ~/.gemini/config.yaml o vía comando).

Como este servidor usa HTTP directo (y no el estándar stdio), puedes usar un "wrapper" o configurar el acceso vía SSE si el servidor es extendido, o usar el plugin de fetch si está disponible.

Ejemplo de configuración (Asumiendo el uso de un proxy stdio-to-http):

# No gemini-cli


gemini mcp add remote-server --command "npx @modelcontextprotocol/inspector http://10.7.0.1:3030/mcp"

En el archivo ~/.gemini/settings.json

"mcpServers": {                                                                                                                      
    "local-mcp": {                                                                                                                                     
      "url": "http://192.168.1.100:3030/mcp",                                                                                                          
      "headers": {                                                                                                                                     
        "Authorization": "Bearer senha-facil-123"                                                                                                      
      }                                                                                                                                                
    }             
  }

Nota: Sustituye la IP por la dirección correcta (ej: 10.7.0.1 de la VPN).

🤖 Configurando Claude Code

Claude Code (y Claude Desktop) generalmente esperan un comando local. Para acceder a este servidor remoto:

1. Edita el archivo claude_desktop_config.json:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Añade la configuración:

{
  "mcpServers": {
    "mcp-simple-server": {
      "command": "curl",
      "args": [
        "-s",
        "-X", "POST",
        "http://10.7.0.1:3030/mcp",
        "-H", "Authorization: Bearer senha-facil-123",
        "-H", "Content-Type: application/json",
        "-d", "{\"jsonrpc\":\"2.0\",\"method\":\"tools/call\",\"params\":<params>}"
      ]
    }
  }
}

Consejo: Para una integración más robusta, se recomienda usar el mcp-proxy que convierte stdio a la API HTTP de tu servidor.

💬 Configurando ChatGPT (GPT Codex / Actions)

Para usar este servidor como una Action en ChatGPT:

1. Ve a Custom GPTs -> Create a GPT -> Configure -> Create new action.

2. En el campo Authentication, elige API Key, selecciona Bearer e inserta: senha-facil-123.

3. En el campo Schema, usa una especificación OpenAPI (ejemplo simplificado a continuación):

openapi: 3.0.0
info:
  title: MCP Simple Server
  version: 1.0.0
servers:
  - url: http://195.35.42.89:3030 # IP Público ou DNS
paths:
  /mcp:
    post:
      operationId: callMcpTool
      summary: Chama uma ferramenta do MCP
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                method: {type: string, example: "tools/call"}
                params: {type: object}
                id: {type: integer, example: 1}
      responses:
        '200':
          description: Sucesso

🐳 Docker

Este proyecto está listo para ser ejecutado en contenedores.

1. Construir la Imagen

Para generar la imagen Docker localmente:

docker build -t mcp-simple-server .

2. Subir el Contenedor (Docker Compose)

La forma recomendada de ejecutarlo es utilizando el docker-compose.yml ya incluido, que configura la red y las variables de entorno:

docker compose up -d

El contenedor será creado con el nombre mcp-simple-server y estará disponible en el puerto 3030.

3. Verificar Estado y Logs

# Ver se o container está rodando
docker ps | grep mcp-simple-server

# Ver logs do servidor
docker compose logs -f

🛠️ Desarrollo

Para ejecutar el servidor localmente:

cd ~/apps/mcp-simple-server
npm install
node server.js

El servidor estará escuchando en http://localhost:3030.