English Français العربية

pREST

السجل الرسمي البيانات وقواعدها

Stdio MCP adapter bridging AI clients to pREST’s HTTP /_mcp endpoint for PostgreSQL APIs.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

OCI package ghcr.io/prest/prest-mcp-adapter:0.1.3
Claude Code 
claude mcp add prest -e 'PREST_MCP_URL=<PREST_MCP_URL>' -e 'PREST_MCP_TOKEN=<your prest_mcp_token>' -e 'PREST_MCP_TIMEOUT_MS=<PREST_MCP_TIMEOUT_MS>' -- docker run -i --rm ghcr.io/prest/prest-mcp-adapter:0.1.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "prest": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/prest/prest-mcp-adapter:0.1.3"
            ],
            "env": {
                "PREST_MCP_URL": "<PREST_MCP_URL>",
                "PREST_MCP_TOKEN": "<your prest_mcp_token>",
                "PREST_MCP_TIMEOUT_MS": "<PREST_MCP_TIMEOUT_MS>"
            }
        }
    }
}

متغيرات البيئة

  • PREST_MCP_URL إلزامي URL of your running pREST HTTP MCP endpoint, for example http://localhost:3000/_mcp
  • PREST_MCP_TOKEN سري Optional bearer token used to authenticate with the pREST MCP endpoint.
  • PREST_MCP_TIMEOUT_MS Optional HTTP timeout in milliseconds. Defaults to 30000.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. pREST MCP Adapter
  2. Requirements
  3. Environment variables
  4. Install
  5. Local usage
  6. MCP client configuration
  7. Security recommendation
  8. Development
  9. License

pREST MCP Adapter

Official stdio adapter for pREST’s HTTP MCP endpoint.

This adapter lets MCP clients that require stdio connect to a running pREST instance exposing an HTTP MCP endpoint at /_mcp.

MCP client / AI IDE
        ↓ stdio (NDJSON JSON-RPC)
prest-mcp
        ↓ HTTP POST
http://localhost:3000/_mcp
        ↓
pREST

The adapter is a tiny transport bridge. It does not introspect schemas, generate SQL, or implement MCP tools. Those live in pREST.

Requirements

  • A running pREST instance with the /_mcp route available
  • Go 1.26+ (to build from source)

Environment variables

VariableRequiredDefaultDescription
PREST_MCP_URLyes—URL of the pREST HTTP MCP endpoint, e.g. http://localhost:3000/_mcp
PREST_MCP_TOKENno—Bearer token when pREST auth is enabled
PREST_MCP_TIMEOUT_MSno30000HTTP timeout in milliseconds

Install

From source
go install github.com/prest/prest-mcp-adapter/cmd/prest-mcp@latest
Docker / OCI
docker pull ghcr.io/prest/prest-mcp-adapter:0.1.3

Local usage

PREST_MCP_URL=http://localhost:3000/_mcp prest-mcp
With token
PREST_MCP_URL=https://api.example.com/_mcp \
PREST_MCP_TOKEN=secret \
prest-mcp
Docker usage
docker run --rm -i \
  -e PREST_MCP_URL=http://host.docker.internal:3000/_mcp \
  ghcr.io/prest/prest-mcp-adapter:0.1.3

MCP client configuration

Cursor

Add to your MCP settings (e.g. .cursor/mcp.json):

{
  "mcpServers": {
    "prest": {
      "command": "prest-mcp",
      "env": {
        "PREST_MCP_URL": "http://localhost:3000/_mcp"
      }
    }
  }
}
Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "prest": {
      "command": "prest-mcp",
      "env": {
        "PREST_MCP_URL": "http://localhost:3000/_mcp"
      }
    }
  }
}
Generic MCP client

Any client that can launch a stdio MCP server:

PREST_MCP_URL=http://localhost:3000/_mcp prest-mcp

Protocol messages are newline-delimited JSON-RPC on stdin/stdout. Logs go only to stderr.

Security recommendation

Use a read-only PostgreSQL user for AI/MCP workflows unless write access is explicitly required.

Do not expose unauthenticated MCP endpoints publicly.

Prefer local or private-network pREST MCP endpoints.

When pREST auth is enabled, set PREST_MCP_TOKEN to a valid JWT.

Development

make test       # go test -race ./... and overall coverage >= 80%
make coverage   # coverage gate only
make vet
make build      # writes bin/prest-mcp

License

MIT — see LICENSE.

الأسئلة الشائعة

ما هو pREST؟

Stdio MCP adapter bridging AI clients to pREST’s HTTP /_mcp endpoint for PostgreSQL APIs.

كيف أثبّت pREST؟

يعمل على جهازك. في Claude Code: claude mcp add prest -e 'PREST_MCP_URL=<PREST_MCP_URL>' -e 'PREST_MCP_TOKEN=<your prest_mcp_token>' -e 'PREST_MCP_TIMEOUT_MS=<PREST_MCP_TIMEOUT_MS>' -- docker run -i --rm ghcr.io/prest/prest-mcp-adapter:0.1.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج pREST إلى مفتاح API؟

نعم. يتطلب PREST_MCP_URL, PREST_MCP_TOKEN، وتضبطها في إعداداته.

هل pREST مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون pREST؟

ينشره prest. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.