Швидкий старт

1 хв читання

Швидкий старт

Запустіть робоче JSON-RPC API з вашої бази PostgreSQL менш ніж за хвилину. Ваша база даних — це ваш бекенд: без фреймворку, без шаблонного коду.

1. Встановлення

Завантажте бінарний файл

# macOS (Homebrew)
brew install heptau/tap/pgarachne

# або завантажте останній реліз для вашої ОС:
#   https://github.com/heptau/pgarachne/releases/latest

2. Підготуйте базу даних

Створіть базу та завантажте схему PgArachne:

createdb my_database
psql -d my_database -f sql/schema.sql

3. Налаштуйте та запустіть

Створіть файл pgarachne.env (сервер знайде його в поточному каталозі):

DB_HOST=localhost
DB_PORT=5432
DB_USER=pgarachne
JWT_SECRET=$(openssl rand -hex 32)

Запустіть сервер:

./pgarachne

4. Визначте функцію

У вашій базі створіть роль і функцію. SQL-коментар функції документує її для LLM.

CREATE ROLE demo_user WITH LOGIN PASSWORD 'user_password';
GRANT USAGE ON SCHEMA api TO demo_user;

CREATE OR REPLACE FUNCTION api.hello_world(payload jsonb)
RETURNS json LANGUAGE sql AS $$
    SELECT '"Hello World"'::json;
$$;
GRANT EXECUTE ON FUNCTION api.hello_world(jsonb) TO demo_user;

5. Викличте її

Ваш API endpoint працює:

curl -X POST http://localhost:8080/db/my_database/jsonrpc \
  -u demo_user:user_password \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"api.hello_world","params":{},"id":1}'
# → {"jsonrpc":"2.0","result":"Hello World","id":1}

6. Підключіть AI-агента (MCP)

Надайте ті самі функції Claude Desktop або Cursor як інструменти через MCP endpoint:

POST http://localhost:8080/db/my_database/mcp

Повні інструкції з підключення: MCP (Model Context Protocol).

Ось і все. Прочитайте посібник Hello World для JWT-автентифікації або порівняння з PostgREST, щоб зрозуміти, куди вписується PgArachne.

← Порівняння з PostgREST Встановлення →

Швидкий старт