Skip to main content
Glama
deenesjakoruzh
limjonathan

runtime-mcp-connect

by limjonathan
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

runtime-mcp

あなたのアプリのライブランタイム状態 — ログ、DBスキーマ、設定、フィーチャーフラグ — をコーディングエージェント向けのMCPツールとして提供します。

npm core npm integrations npm connect node tests license

アプリに差し込むだけで、エージェントは推測をやめます。

今日、opencode、Claude Code、Cursor があなたのアプリをデバッグするとき、彼らは盲目的に動いています。スキーマに対する古い推測、貼り付けられたログ断片、でっち上げられた設定値。

runtime-mcp がそのギャップを埋めます。2行のセットアップで、MCPに対応したエージェントは、実行中のプロセスが実際に認識している状態を照会できるようになります。

Agent: "why is checkout failing?"
  ├─ get_errors   → TypeError at checkout.ts:42, full stack trace
  ├─ db_query     → orders table has no `coupon_id` column
  ├─ config://    → STRIPE_KEY: [REDACTED], TAX_RATE: 0  ← there it is
  └─ "Found it — you renamed the env var."

クイックスタート

0 — インストール:

npm install runtime-mcp runtime-mcp-integrations

1 — アプリを計装する（インポート1つ）:

import { runtimeMcp } from 'runtime-mcp';
import { pgAdapter } from 'runtime-mcp-integrations/pg';

await runtimeMcp({
  db: pgAdapter(pool),
  config: process.env,
  flags: myFlagRegistry,
});

2 — プロジェクトの .mcp.json にシムを登録する:

{
  "mcpServers": {
    "runtime": { "command": "npx", "args": ["-y", "runtime-mcp-connect"] }
  }
}

3 — アプリを起動します。 これで完了です。エージェントが自動的に接続し、以降はライブ状態を参照できます。

Related MCP server: Engineering Intelligence MCP

エージェントが得られるもの

ツール

Tool

説明

get_logs

最近のログ · レベル、フリーテキスト検索、時間範囲でフィルタ

get_errors

スタックトレース付きのエラーエントリ — 問題発生時に最初に確認するもの

db_query

読み取り専用SQL（SELECT/WITH のみ） · 書き込みは拒否 · LIMIT 自動付与

app_info

名前、バージョン、PID、稼働時間、登録済みルート

リソース

Resource

説明

config://current

シークレットが [REDACTED] に置き換えられたライブ設定

flags://state

環境ごとのフィーチャーフラグ状態

schema://tables

テーブル一覧

schema://table/{name}

列、主キー、インデックス、外部キー

アーキテクチャ

┌──────────────────────────────┐          ┌─────────────────────────────┐
│         Your App             │          │   Agent (opencode/Claude)   │
│                              │          │                             │
│  runtimeMcp({ db, config })  │          │  .mcp.json                  │
│   ├─ log ring buffer         │          │    └─ runtime-mcp-connect   │
│   ├─ schema introspection    │          │          │ stdio            │
│   ├─ config + redaction      │◄─────────┼──────────┘                  │
│   └─ feature flags           │  loopback│                             │
│                              │   HTTP   │                             │
│  127.0.0.1:<port>/mcp        │          │                             │
│  .runtime-mcp.json ──────────┼─ pid·url·token·(chmod 600)             │
└──────────────────────────────┘          └─────────────────────────────┘

なぜ2つの部品なのか？ エージェントは独自のプロセスを起動するため、アプリの中に直接アクセスできません。ディスカバリファイルがその橋渡しをします。ライブラリは起動時にファイルを書き込み、シムは呼び出しのたびにそれを読み取ります。新しいポートやトークンでアプリを再起動しましたか？ シムが自動的に再接続します。再設定は何も必要ありません。

アダプター

npm install runtime-mcp runtime-mcp-integrations

構造化ロギングの例:

import pino from 'pino';
import { createRuntimeMcpPinoDestination } from 'runtime-mcp-integrations/pino';

const logger = pino(pino.multistream([
  pino.destination(1),
  createRuntimeMcpPinoDestination(),
]));

ロガーを組み込んでいない？ コンソールキャプチャはデフォルトで有効です — console.error などは同じバッファに流れます。

セキュリティモデル

ローカル開発とステージング向けに設計されています。デフォルトで多層防御を備えています。

制御

動作

ループバックバインド

エンドポイントは 127.0.0.1 のみでリッスン。リモート公開には明示的なオプトインが必要

トークン認証

アプリ起動ごとのベアラートークン。.runtime-mcp.json に chmod 600 で保存

読み取り専用SQL

許可リストパーサー: SELECT 以外は拒否、スタックされたステートメントは拒否、文字列/コメント内のキーワードは無視

シークレット秘匿化

パスワード/トークン/キー/auth 系のキーと既知のトークンフォーマットは、プロセス外に送信される前に [REDACTED] になる

テレメトリなし

外部への送信ゼロ

.runtime-mcp.json を .gitignore に追加してください。

なぜ今なのか

既存のソリューション

制限

Next.js 16 /_next/mcp

フレームワーク固定

Vercel runtime logs MCP

クラウドプラットフォーム限定

Datadog / Sentry / Supabase MCPs

SaaSアカウント向け。ライブな開発プロセスには非対応

どのプラットフォームもこれを内側向けに作っています。誰も汎用には作っていません。 これがそれです。

デモ

packages/demo-app は Express + SQLite のストアで、2つの意図的に仕込まれたバグがあります — /orders での N+1 クエリと、名前を間違えた DEMO_TAX_RATE 環境変数（これによりチェックアウト税が静かにゼロになります）。エージェントをそこに向けて、"チェックアウトの合計金額がなぜ間違っているのか？" と尋ねてください。

pnpm install && pnpm -r build
pnpm --filter @runtime-mcp/demo-app dev

パッケージ

すべてのパッケージは npm（v0.1.0）に公開されています:

パッケージ

npm

目的

runtime-mcp

npm ↗

プロセス内レジストリ · ループバックエンドポイント · ディスカバリ · 秘匿化

runtime-mcp-connect

npm ↗

エージェントが .mcp.json に登録する stdio シム

runtime-mcp-integrations

npm ↗

フレームワーク、ロガー、データベースのアダプター

@runtime-mcp/demo-app

—

意図したバグを仕込んだデバッグ用デモ（リポジトリ限定）

Node ≥ 20 が必要です。ESM。

開発

pnpm install
pnpm -r build
pnpm test    # unit + end-to-end over real HTTP and stdio transports

  • MCP リソースサブスクリプションによるライブログのテーリング

  • Fastify / Hono アダプター

  • MySQL / Drizzle イントロスペクションアダプター

  • Python SDK の同等対応（FastAPI / Django）

  • connect シムでのマルチプロジェクトワークスペース

ライセンス

MIT

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

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers