MCP Simple Server (HTTP-Bridge)

Dies ist ein vereinfachter MCP-Server (Model Context Protocol), der Tools über eine HTTP-POST-Schnittstelle bereitstellt. Er ermöglicht es LLMs und Remote-Agenten, sicher über einen Tunnel oder direkten Zugriff auf lokale oder spezifische Funktionen zuzugreifen.

🚀 Technische Konfigurationen

• Port: 3030

• Endpunkt: /mcp

• Methode: POST

• Authentifizierung: Authorization: Bearer senha-facil-123

• Protokoll: JSON-RPC 2.0 (angepasst für HTTP)

Related MCP server: local-env-mcp

🧪 Remote-Tests mit CURL

Sie können die Funktionsweise des Servers von jedem Rechner mit Netzwerkzugriff (oder über ein Wireguard-VPN) mit den folgenden Befehlen validieren.

1. Verfügbare Tools auflisten

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. Das Tool 'hello' aufrufen

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}'

♊ Gemini-CLI konfigurieren (Remote)

Damit die gemini-cli auf Ihrem lokalen Rechner oder einem anderen VPS auf diesen Server zugreifen kann, müssen Sie sie in der Konfigurationsdatei der Gemini CLI (normalerweise unter ~/.gemini/config.yaml oder per Befehl) konfigurieren.

Da dieser Server direktes HTTP verwendet (und nicht den Standard-stdio), können Sie einen "Wrapper" verwenden, den Zugriff über SSE konfigurieren, falls der Server erweitert wurde, oder das Fetch-Plugin verwenden, falls verfügbar.

Konfigurationsbeispiel (unter der Annahme der Verwendung eines stdio-to-http-Proxys):

# No gemini-cli


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

In der Datei ~/.gemini/settings.json

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

Hinweis: Ersetzen Sie die IP durch die korrekte Adresse (z. B. 10.7.0.1 des VPNs).

🤖 Claude Code konfigurieren

Claude Code (und Claude Desktop) erwarten normalerweise einen lokalen Befehl. Um auf diesen Remote-Server zuzugreifen:

1. Bearbeiten Sie die Datei claude_desktop_config.json:

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

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

2. Fügen Sie die Konfiguration hinzu:

{
  "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>}"
      ]
    }
  }
}

Tipp: Für eine robustere Integration wird empfohlen, den mcp-proxy zu verwenden, der stdio in die HTTP-API Ihres Servers konvertiert.

💬 ChatGPT konfigurieren (GPT Codex / Actions)

Um diesen Server als Action in ChatGPT zu verwenden:

1. Gehen Sie zu Custom GPTs -> Create a GPT -> Configure -> Create new action.

2. Wählen Sie im Feld Authentication die Option API Key, wählen Sie Bearer und geben Sie ein: senha-facil-123.

3. Verwenden Sie im Feld Schema eine OpenAPI-Spezifikation (vereinfachtes Beispiel unten):

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

Dieses Projekt ist bereit für die Ausführung in Containern.

1. Image erstellen

Um das Docker-Image lokal zu erstellen:

docker build -t mcp-simple-server .

2. Container starten (Docker Compose)

Die empfohlene Methode zum Ausführen ist die Verwendung der bereits enthaltenen docker-compose.yml, die das Netzwerk und die Umgebungsvariablen konfiguriert:

docker compose up -d

Der Container wird mit dem Namen mcp-simple-server erstellt und ist auf Port 3030 verfügbar.

3. Status und Logs überprüfen

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

# Ver logs do servidor
docker compose logs -f

🛠️ Entwicklung

Um den Server lokal auszuführen:

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

Der Server lauscht auf http://localhost:3030.