elog-mcp

OpenAPI/MCP サーバーは、LLMエージェントにELOG電子ログブックへの 読み取り専用アクセスをHTTP経由で提供します。参照デプロイメント: T2K/ND280 elog at https://elog.nd280.org/elog/; 標準のelogdインスタンスで動作します。

• エントリを全文（正規表現）、属性、日付範囲で検索

• エントリを完全に読む（属性 + 本文 + 添付ファイル）

• 添付ファイルをダウンロードし、ログブックを発見

厳密に読み取り専用: HTTP GETリクエストのみが発行されます。TLS検証はデフォルトで有効です。 認証情報は環境からのみ取得され、ログに記録されたりエコーされたりすることはありません。

Setup

Python ≥ 3.10 と uv が必要です:

uv sync

Related MCP server: mcp-opensearch

Configuration

すべての設定は環境変数（ELOG_ プレフィックス）です:

すべてのデプロイメントに共通のプレフィックス:

export ELOG_URL=https://elog.nd280.org/elog
export ELOG_USER=your-shared-user
export ELOG_PASSWORD=your-shared-password

Deployment

ELOG_MCP_TRANSPORT はクライアントがサーバーと通信する方法を選択します:

stdio (local MCP clients)

uv run elog-mcp

Claude Desktop（claude_desktop_config.json）:

{
  "mcpServers": {
    "elog": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/elog-mcp", "run", "elog-mcp"],
      "env": { "ELOG_URL": "…", "ELOG_USER": "…", "ELOG_PASSWORD": "…" }
    }
  }
}

opencode（~/.config/opencode/opencode.json）:

{
  "mcp": {
    "elog": {
      "type": "local",
      "command": ["uv", "--directory", "/absolute/path/to/elog-mcp", "run", "elog-mcp"],
      "environment": { "ELOG_URL": "…", "ELOG_USER": "…", "ELOG_PASSWORD": "…" }
    }
  }
}

streamable-http (remote MCP clients)

ELOG_MCP_TRANSPORT=streamable-http uv run elog-mcp

UIで http://127.0.0.1:8000/mcp をリモートMCPサーバーとして登録してください。

openapi (Open WebUI & friends)

ELOG_MCP_TRANSPORT=openapi \
ELOG_API_KEY=pick-a-random-secret \
uv run elog-mcp

5つの読み取り専用エンドポイントは以下のツールをミラーリングします（operationIdsはツール名と同じ）。Open WebUIでは: Settings → Tools → +（ユーザーレベル、ブラウザで取得）または Admin Settings → Tools（グローバル、バックエンドで取得）で、サーバーURLを入力し、ELOG_API_KEY の値をBearerキーフィールドに入れてください。

HTTPS: ELOG_MCP_CERTFILE/ELOG_MCP_KEYFILE を渡すか、リバースプロキシまたはトンネル（例: cloudflared tunnel --url http://localhost:8000）を前面に配置します。ローカルで信頼された開発用証明書の場合: mkcert -install && mkcert localhost 127.0.0.1 ::1 を実行し、その2つのファイルを上記の変数に（絶対パスで）渡します。

到達可能性の経験則:

• デフォルトではすべて 127.0.0.1 にバインドされます。他の誰かがサーバーに到達する必要がある場合は、ELOG_MCP_HOST=0.0.0.0 と ELOG_API_KEY を設定してください。

• Docker内のクライアント？ そのコンテナ内の 127.0.0.1 はあなたのマシンではありません — http://host.docker.internal:<port> を使用してください（Linuxでは --add-host=host.docker.internal:host-gateway）。

• ホスト型インスタンス（例: 大学のWebUI）？ それはあなたのラップトップのループバックに到達できません。ユーザーレベルのツールサーバーはさらにそのサイトのContent-Security-Policyの影響を受けます — DevToolsがリクエストを Transferred: CSP と表示した場合、ブラウザがブロックしており、IT側の connect-src 変更のみが有効です。実用的な方法: elog-mcpを到達可能な場所にデプロイし、管理者に一度グローバルツールサーバーとして登録してもらいます。

Tools

すべてのトランスポートで同じ5つの操作（RESTルートは openapi 用に表示）:

注記:

• テキストと属性のフィルタは正規表現です（elogdセマンティクス）; ^value$ アンカーで完全一致になります。

• 日付: YYYY-MM-DD[ HH:MM[:SS]]、または範囲の代わりに last_days を使用; logbook="*" は既知のすべてのログブックを検索します。

• エラーは一貫して表示されます: EntryNotFound、AuthFailed、ServerError、NetworkError、InvalidLogbook（RESTステータスコード: 404/502/502/503/404、無効なクエリパラメータは 400/422）。

Development

uv run pytest                # unit tests, offline
uv run pytest -m live        # live suite (needs ELOG_TEST_URL)
uv run ruff check .          # lint
uv run ruff format --check . # formatting gate
uv run mypy src              # type check (strict)

プロトコルの詳細とワイヤーフォーマットの参照は RESOURCES.md にあります。アーキテクチャとツール契約は SPEC.md にあります。