Barrel
EN GitHub

Une session MCP avec curl

Ce script dialogue avec le point d’accès MCP de barrel_server comme le fait un agent, un message JSON-RPC à la fois : il initialise une session, liste les outils, crée une base, écrit et lit des documents, exécute une requête BQL et une recherche par sous-chaîne, puis termine la session. Il affiche chaque requête et le résultat d’outil reçu. Utilisez-le pour voir le format échangé avant de connecter un client MCP, ou pour tester un serveur que vous avez déployé.

Prérequis

  • Un barrel_server en marche (1.13 ou plus récent). Depuis une copie du dépôt barrel :

    rebar3 as server compile
    rebar3 as server shell

    Le shell démarre barrel_server sur le port 8080, sans authentification.

  • curl et jq.

Exécuter

BARREL_URL=http://localhost:8080 ./run.sh

Sur un serveur avec authentification bearer, définissez aussi BARREL_TOKEN. Le script supprime et recrée la base mcp_demo (en REST) pour que chaque exécution parte de zéro.

Ce que montre l’exemple

  • POST /mcp avec initialize renvoie l’identifiant de session dans l’en-tête de réponse mcp-session-id ; chaque requête suivante le renvoie, avec mcp-protocol-version: 2025-06-18.
  • initialize et tools/list répondent en JSON simple ; tools/call répond en server-sent events (data: {...}). Le script garde le JSON.
  • Un résultat d’outil est un document JSON dans le contenu texte. Un appel en échec reste un résultat, avec isError: true, par exemple {"error":"not_found"}.
  • DELETE /mcp termine la session (204).

Notes

  • ngram_search trouve des sous-chaînes exactes sans configuration supplémentaire. search en mode bm25 ou hybrid nécessite BM25 ou un embedder configuré sur la base ; sur un serveur par défaut, il renvoie un résultat d’erreur.
  • /mcp n’accepte que des jetons bearer (un jeton serveur ou un jeton de capacité), pas les requêtes signées ni mTLS.

Sortie attendue

Les requêtes et les résultats, dans l’ordre. La sortie d’une exécution réelle se trouve dans expected.txt ; l’identifiant de session et les révisions changent à chaque exécution.

Télécharger Le dossier sur GitHub, avec tous les fichiers ci-dessous.

Code source

run.sh
#!/bin/sh
# One MCP session against a running barrel_server, with curl.
#   BARREL_URL (default http://localhost:8080)
#   BARREL_TOKEN (optional bearer, for a server with auth)
# Needs curl and jq.
set -eu
URL="${BARREL_URL:-http://localhost:8080}"
DB=mcp_demo
HDRS=$(mktemp)
trap 'rm -f "$HDRS"' EXIT
AUTH=""
[ -n "${BARREL_TOKEN:-}" ] && AUTH="authorization: Bearer $BARREL_TOKEN"

# post <json>: POST one JSON-RPC message to /mcp, print the body.
# tools/call answers as SSE ("data: {...}"): keep the JSON.
post() {
  curl -sS -D "$HDRS" -X POST "$URL/mcp" \
    -H 'content-type: application/json' \
    -H 'accept: application/json, text/event-stream' \
    -H 'mcp-protocol-version: 2025-06-18' \
    ${SID:+-H "mcp-session-id: $SID"} \
    ${AUTH:+-H "$AUTH"} \
    -d "$1" | awk '/^data: /{print substr($0, 7); next} /^\{/'
}

# call <id> <tool> <arguments>: print the request, then the tool
# result (a JSON document in the text content).
call() {
  req="{\"jsonrpc\":\"2.0\",\"id\":$1,\"method\":\"tools/call\","
  req="$req\"params\":{\"name\":\"$2\",\"arguments\":$3}}"
  echo "--> $req"
  post "$req" | jq '{isError: (.result.isError // false),
                     result: (.result.content[0].text | fromjson)}'
  echo
}

# Start from an empty database (REST, outside MCP).
curl -sS -o /dev/null -X DELETE ${AUTH:+-H "$AUTH"} \
  "$URL/db/$DB?purge=true" || true

INIT='{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'
echo "--> $INIT"
SID=""
post "$INIT" | jq -c '.result | {protocolVersion, serverInfo}'
SID=$(tr -d '\r' < "$HDRS" | awk -F': ' 'tolower($1)=="mcp-session-id"{print $2}')
echo "mcp-session-id: $SID"
echo

echo '--> {"jsonrpc":"2.0","method":"notifications/initialized"}'
post '{"jsonrpc":"2.0","method":"notifications/initialized"}'
sed -n '1s/\r$//p' "$HDRS"
echo

echo '--> {"jsonrpc":"2.0","id":2,"method":"tools/list"}'
post '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
  | jq -r '"\(.result.tools | length) tools:",
           (.result.tools | map(.name) as $n
            | range(0; $n | length; 4) | $n[.:. + 4] | join(", "))'
echo

call 3 db_create "{\"db\":\"$DB\"}"
call 4 doc_put "{\"db\":\"$DB\",\"doc\":{\"id\":\"note-1\",\"title\":\"stored over MCP\",\"tags\":[\"mcp\"]}}"
call 5 doc_put "{\"db\":\"$DB\",\"doc\":{\"id\":\"note-2\",\"title\":\"release checklist\",\"tags\":[\"ops\"]}}"
call 6 doc_get "{\"db\":\"$DB\",\"id\":\"note-1\"}"
call 7 query "{\"db\":\"$DB\",\"query\":\"SELECT id, title FROM c WHERE 'ops' IN tags LIMIT 5\"}"
call 8 ngram_search "{\"db\":\"$DB\",\"query\":\"over MCP\"}"
call 9 doc_get "{\"db\":\"$DB\",\"id\":\"missing\"}"

echo "--> DELETE /mcp"
curl -sS -o /dev/null -w '%{http_code}\n' -X DELETE "$URL/mcp" \
  -H "mcp-session-id: $SID" ${AUTH:+-H "$AUTH"}

Sortie attendue

Le fichier expected.txt de l’exemple, issu d’une exécution réelle. Les révisions, identifiants, jetons et horodatages changent à chaque exécution ; scripts/verify-examples.sh les masque avant de comparer.

expected.txt
--> {"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}
{"protocolVersion":"2025-06-18","serverInfo":{"name":"barrel","version":"4.5.1"}}
mcp-session-id: mcp_07e8b892aebc73ad4d6ae187860202d9

--> {"jsonrpc":"2.0","method":"notifications/initialized"}
HTTP/1.1 202 Accepted

--> {"jsonrpc":"2.0","id":2,"method":"tools/list"}
39 tools:
branch_create, branch_list, changes, context_attach
context_capabilities, context_detach, context_discover, context_import
context_inspect, context_list, context_materialize, context_offline
context_query, context_working_set_delete, context_working_sets, db_create
db_info, db_list, doc_delete, doc_get
doc_put, handoff_accept, handoff_complete, handoff_create
handoff_list, merge, ngram_search, query
query_subscribe, query_unsubscribe, search, session_add_message
session_create, session_get_messages, session_touch, space_create
space_grant, space_info, space_revoke

--> {"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"db_create","arguments":{"db":"mcp_demo"}}}
{
  "isError": false,
  "result": {
    "ok": true,
    "db": "mcp_demo"
  }
}

--> {"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"doc_put","arguments":{"db":"mcp_demo","doc":{"id":"note-1","title":"stored over MCP","tags":["mcp"]}}}}
{
  "isError": false,
  "result": {
    "id": "note-1",
    "ok": true,
    "rev": "000001a1ba5581d600000000@w9c81a31430ff0acd"
  }
}

--> {"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"doc_put","arguments":{"db":"mcp_demo","doc":{"id":"note-2","title":"release checklist","tags":["ops"]}}}}
{
  "isError": false,
  "result": {
    "id": "note-2",
    "ok": true,
    "rev": "000001a1ba55822000000000@w9c81a31430ff0acd"
  }
}

--> {"jsonrpc":"2.0","id":6,"method":"tools/call","params":{"name":"doc_get","arguments":{"db":"mcp_demo","id":"note-1"}}}
{
  "isError": false,
  "result": {
    "_rev": "000001a1ba5581d600000000@w9c81a31430ff0acd",
    "id": "note-1",
    "tags": [
      "mcp"
    ],
    "title": "stored over MCP"
  }
}

--> {"jsonrpc":"2.0","id":7,"method":"tools/call","params":{"name":"query","arguments":{"db":"mcp_demo","query":"SELECT id, title FROM c WHERE 'ops' IN tags LIMIT 5"}}}
{
  "isError": false,
  "result": {
    "count": 1,
    "rows": [
      {
        "id": "note-2",
        "title": "release checklist"
      }
    ],
    "has_more": false
  }
}

--> {"jsonrpc":"2.0","id":8,"method":"tools/call","params":{"name":"ngram_search","arguments":{"db":"mcp_demo","query":"over MCP"}}}
{
  "isError": false,
  "result": {
    "count": 1,
    "hits": [
      {
        "id": "note-1",
        "spans": [
          [
            7,
            8
          ]
        ]
      }
    ]
  }
}

--> {"jsonrpc":"2.0","id":9,"method":"tools/call","params":{"name":"doc_get","arguments":{"db":"mcp_demo","id":"missing"}}}
{
  "isError": true,
  "result": {
    "error": "not_found"
  }
}

--> DELETE /mcp
204

Haut et bas pour se déplacerEntrée pour ouvrir