Skip to main content
Glama
deenesjakoptruzh
slackwarecps

MCP Simple Server

by slackwarecps
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

MCP Simple Server (HTTP-мост)

Это упрощенный сервер MCP (Model Context Protocol), который предоставляет инструменты через интерфейс HTTP POST. Он позволяет LLM и удаленным агентам безопасно получать доступ к локальным или специфическим функциям через туннель или прямое подключение.

🚀 Технические настройки

  • Порт: 3030

  • Эндпоинт: /mcp

  • Метод: POST

  • Аутентификация: Authorization: Bearer senha-facil-123

  • Протокол: JSON-RPC 2.0 (адаптирован для HTTP)

Related MCP server: local-env-mcp

🧪 Удаленное тестирование с помощью CURL

Вы можете проверить работу сервера с любого компьютера, имеющего доступ к сети (или через VPN Wireguard), используя команды ниже.

1. Список доступных инструментов

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. Вызов инструмента '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}'

♊ Настройка Gemini-CLI (удаленно)

Чтобы gemini-cli на вашем локальном компьютере или другом VPS мог получить доступ к этому серверу, его необходимо настроить в файле конфигурации Gemini CLI (обычно ~/.gemini/config.yaml или через команду).

Поскольку этот сервер использует прямой HTTP (а не стандартный stdio), вы можете использовать «обертку» (wrapper), настроить доступ через SSE, если сервер расширен, или использовать плагин fetch, если он доступен.

Пример конфигурации (предполагается использование прокси stdio-to-http):

# No gemini-cli


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

В файле ~/.gemini/settings.json

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

Примечание: Замените IP на правильный адрес (например, 10.7.0.1 из VPN).

🤖 Настройка Claude Code

Claude Code (и Claude Desktop) обычно ожидают локальную команду. Чтобы получить доступ к этому удаленному серверу:

  1. Отредактируйте файл claude_desktop_config.json:

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

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

  2. Добавьте конфигурацию:

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

Совет: Для более надежной интеграции рекомендуется использовать mcp-proxy, который преобразует stdio в HTTP API вашего сервера.

💬 Настройка ChatGPT (GPT Codex / Actions)

Чтобы использовать этот сервер в качестве Action в ChatGPT:

  1. Перейдите в Custom GPTs -> Create a GPT -> Configure -> Create new action.

  2. В поле Authentication выберите API Key, выберите Bearer и введите: senha-facil-123.

  3. В поле Schema используйте спецификацию OpenAPI (упрощенный пример ниже):

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

Этот проект готов к запуску в контейнерах.

1. Сборка образа

Для локальной генерации Docker-образа:

docker build -t mcp-simple-server .

2. Запуск контейнера (Docker Compose)

Рекомендуемый способ запуска — использование включенного в комплект docker-compose.yml, который настраивает сеть и переменные окружения:

docker compose up -d

Контейнер будет создан с именем mcp-simple-server и будет доступен на порту 3030.

3. Проверка статуса и логов

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

# Ver logs do servidor
docker compose logs -f

🛠️ Разработка

Для локального запуска сервера:

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

Сервер будет прослушивать http://localhost:3030.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • mempalace-mcp-http

    flejz
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables remote access to the MemPalace MCP server via HTTP, supporting bearer token authentication and concurrent clients while exposing all mempalace tools.
    -

  • Levitate

    iomz
    A
    license
    Not graded
    quality
    A
    maintenance
    Lifts local stdio MCP servers into remote Streamable HTTP endpoints for cloud-hosted AI clients, with bearer-token auth and tool policy filtering.
    9 npm
    MIT

  • mcp2api

    megamen32
    F
    license
    Not graded
    quality
    C
    maintenance
    Converts any MCP server into simple HTTP endpoints, enabling AI agents that only support HTTP (like ChatGPT Custom GPT or web_fetch) to use MCP tools.
    -