de en es ja ko ru zh

runtime-mcp-connect

Name: runtime-mcp-connect
Author: limjonathan

by limjonathan

Overview Schema Related Servers Score Discussions

TypeScript

Local

runtime-mcp

앱의 실시간 런타임 상태 — 로그, DB 스키마, 설정, 기능 플래그 — 코딩 에이전트를 위한 MCP 도구로 제공합니다.

npm core npm integrations npm connect node tests license

앱에 넣기만 하세요. 에이전트가 더 이상 추측하지 않습니다.

오늘날 opencode, Claude Code, Cursor가 앱을 디버깅할 때, 그들은 맹목적으로 작업합니다: 스키마에 대한 낡은 추측, 붙여넣은 로그 조각, 지어낸 설정 값들.

runtime-mcp가 그 격차를 메웁니다. 두 줄의 설정만으로 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 — 앱에 계측 추가 (import 한 줄):

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에 shim 등록:

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

3 — 앱을 시작하세요. 그게 전부입니다. 에이전트가 자동으로 연결되어 그때부터 실시간 상태를 확인합니다.

에이전트가 얻는 것

도구

도구	설명
`get_logs`	최근 로그 · 레벨, 자유 텍스트 검색, 시간 범위로 필터링
`get_errors`	스택 트레이스가 포함된 오류 항목 — 문제 발생 시 가장 먼저 호출
`db_query`	읽기 전용 SQL (`SELECT`/`WITH`만 허용) · 쓰기 거부 · 자동 `LIMIT`
`app_info`	이름, 버전, PID, 가동 시간, 등록된 라우트

리소스

리소스	설명
`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)             │
└──────────────────────────────┘          └─────────────────────────────┘

왜 두 부분으로 나뉘나요? 에이전트는 자신만의 프로세스를 생성합니다 — 앱 내부에 접근할 수 없습니다. 디스커버리 파일이 그 둘을 연결합니다: 라이브러리는 부팅 시 파일을 작성하고, shim은 호출할 때마다 파일을 읽습니다. 앱이 새 포트나 토큰으로 재시작되었나요? shim이 자동으로 재연결합니다. 다시 설정할 필요가 전혀 없습니다.

어댑터

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`에서만 수신 · 원격 노출은 명시적 옵트인 필요
토큰 인증	앱 시작 시 Bearer 토큰 생성, `.runtime-mcp.json`에 chmod 600으로 저장
읽기 전용 SQL	허용 목록 파서: `SELECT`가 아닌 것 거부, 연속 문장 거부, 문자열/주석 내부의 키워드 무시
비밀 값 마스킹	password/token/key/auth 형태의 키와 알려진 토큰 형식은 프로세스 밖으로 나가기 전에 `[REDACTED]`로 변환
텔레메트리 없음	외부 전송 제로

.runtime-mcp.json을 .gitignore에 추가하세요.

왜 지금인가

기존 솔루션	한계점
Next.js 16 `/_next/mcp`	프레임워크 종속
Vercel 런타임 로그 MCP	클라우드 플랫폼 전용
Datadog / Sentry / Supabase MCP	SaaS 계정 필요 · 실제 개발 프로세스 아님

모든 플랫폼이 이 방향으로 만들고 있습니다. 하지만 범용적으로 만든 곳은 없습니다. 이것이 바로 그것입니다.

데모

packages/demo-app은 Express + SQLite 스토어로, 두 개의 심어진 버그가 있습니다 — /orders의 N+1 쿼리, 그리고 체크아웃 세금을 조용히 0으로 만드는 잘못된 이름의 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 shim
`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 shim의 다중 프로젝트 워크스페이스

라이선스

MIT

This server cannot be installed

license - not tested

Not graded

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

BankBridge
Read-only bank access for your AI agent. Connects Claude, ChatGPT, Cursor, Gemini, Codex.
Lobu
Shared, permission-aware company context for AI agents, with provenance, approvals and audit.
Auralogs
Read-only access to Auralogs production logs: search logs, inspect errors, review AI analyses.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/limjonathan/runtime-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server