Skip to main content
Glama
oss-analyzer

oss-analyzer

by ParkBeomsoo

beom-oss-analyzer

오픈소스를 빠짐없이 분석하고, 필요한 기능만 내 저장소로 옮겨 원본과 같은지 검증하는 툴킷

version python license

남이 만든 기능을 "대충 읽고 따라 만들기" 대신, 코드 전체를 근거(파일:줄)와 함께 분석하고 옮긴 결과가 원본과 같은 동작인지 프로그램으로 확인합니다. Claude Code 같은 AI 에이전트가 절차를 따라 쓰도록 스킬·MCP 도구·CLI 를 함께 제공하고, AI 가 혼자 정하면 안 되는 일은 사람 승인 없이는 끝나지 않게 막습니다.

목차

Related MCP server: CodeGraph

무엇을 하나

하고 싶은 일

툴킷이 하는 일

기능을 빠짐없이 파악

모든 파일을 분류하고 모든 함수를 검토 단위로 나눠, 결론마다 근거(파일:줄)를 붙입니다. 확정하지 못한 것은 "미확인 목록"으로 남깁니다.

실제 API 목록

프레임워크별 규칙으로 HTTP·CLI 진입점을 찾고, 코드에서 조립되는 URL 까지 펼쳐 실제 경로 목록을 만듭니다.

고치기 전 영향 확인

바꾸려는 함수가 어디에 영향을 주는지(호출자·구현체·진입점·테스트), 코어를 건드리지 않고 끼울 수 있는 확장 포인트가 어디인지 보여 줍니다.

원본 업데이트 따라가기

두 버전을 비교해 우리 수정과 부딪히는 곳(함수 삭제·이름 변경·시그니처 변경)을 찾습니다.

기능만 골라 옮기기

진입점 하나에서 필요한 코드·상태·설정·외부 의존을 잘라 내고, 항목마다 어디로 옮겼는지 원장에 기록합니다. 다른 언어로 다시 만들어도 됩니다.

옮긴 결과 검증

같은 입력을 원본과 내 코드에 넣어 결과를 비교합니다(HTTP·CLI·함수 단위). 일부러 바꾼 동작은 기대값과, 원본에 없는 새 동작도 기대값으로 검증합니다.

AI 지름길 차단

차이 허용·기능 생략·테스트 축소·기대값은 사람 승인 전까지 완료가 안 됩니다. 검증 뒤 코드가 바뀌거나 기록을 툴킷 밖에서 고치면 잡아냅니다.

핵심 개념

근거 등급 — 결론이 얼마나 확실한지를 등급으로 남깁니다.

등급

뜻

얻는 방법

L0

코드를 읽고 구조 지도로 확인

기본

L1

언어 서버로 호출·참조 확인

lsp

L2

값이 어디서 어디로 흐르는지 확인

dataflow

L3

실제로 실행되는 것을 확인

커버리지 리포트, 차등 검증

원장 — 분석·포팅 상태는 프로젝트별 SQLite 원장(~/.oss-analyzer/projects/<id>/ledger.db)에 쌓입니다. 세션이 바뀌어도, 여러 에이전트가 동시에 일해도 같은 기록을 이어 씁니다.

포팅 완료 조건 (게이트 7개) — 전부 충족해야 port-finish 가 완료 판정을 냅니다.

  1. 옮길 항목이 모두 처리됨 (옮김 / 대체 / 생략)

  2. 옮긴 위치가 지금도 그대로 있음 (줄 내용까지)

  3. 차등 검증 통과 — 마지막으로 저장한 케이스 전부, 지금 코드 기준 (검증 뒤 코드가 바뀌면 무효)

  4. 케이스가 옮길 함수를 모두 실행함 (원본 커버리지, 안 되면 내 코드 커버리지)

  5. 사람 확인 항목이 모두 승인됨 (차이 허용·생략·케이스 변경·기대값, 승인 뒤 내용이 바뀌면 무효)

  6. 기록이 툴킷 밖에서 바뀌지 않음 (원장 해시 사슬·골든 해시)

  7. 라이선스 확인이 필요한 파일이 없음

모든 포팅 명령 응답에는 next_step(다음에 할 일)이 붙습니다.

요구 사항

구분

내용

필수

Python 3.11+, git

필수 엔진

구조 지도 엔진, 진입점 규칙 엔진 — setup 이 설치 (체크섬 검증)

선택

언어 서버(L1), 데이터 흐름 엔진(L2, JDK 21+), 커버리지 도구(L3), 컨테이너 엔진(남의 코드 격리 실행)

언어 서버(L1)

Rust · Java · Kotlin · TypeScript/JavaScript · Python · Go · C/C++ · C# · Dart · Ruby (그 밖의 언어는 L0 까지, 파일·심볼 분류는 언어와 무관)

진입점 규칙

Axum · Spring · Express · FastAPI/Flask · Gin · clap · Next.js (규칙이 없는 프레임워크는 자동으로 미확인 처리)

엔진 이름·라이선스·설치 위치는 THIRD_PARTY.md 에 있습니다.

설치

# 1. 툴킷 설치 — 어느 폴더에서나 oss-analyzer 명령으로 쓸 수 있게
pipx install git+https://github.com/ParkBeomsoo/beom-oss-analyzer.git
# (또는) uv tool install git+https://github.com/ParkBeomsoo/beom-oss-analyzer.git

# 2. 상태 점검 — 엔진·언어 서버·스킬·MCP 등록
oss-analyzer doctor

# 3. 엔진 설치 — 먼저 계획만 보고, 고른 것만 설치
oss-analyzer setup --languages python typescript
oss-analyzer setup --apply codebase-memory-mcp ast-grep lsp:python lsp:typescript coverage
  • setup 은 아무 옵션 없이 실행하면 계획만 보여 주고 아무것도 바꾸지 않습니다. --apply 에 적은 것만 설치합니다.

  • 남의 코드를 격리해서 실행하려면 컨테이너 엔진이 필요합니다. Windows 는 setup --apply sandbox 가 WSL 배포판 안에 컨테이너 엔진을 설치합니다 (데스크톱 앱 불필요). 이미 docker 가 있으면 그것을 씁니다.

  • JDK·Node.js·Go·Rust 같은 언어 런타임은 직접 설치합니다.

AI 에이전트(Claude Code) 연동

둘 중 하나만 씁니다.

# A. setup 으로 스킬 + MCP 등록
oss-analyzer setup --apply skill mcp-register
oss-analyzer setup --apply skill mcp-register --scope project --project-dir <프로젝트>   # 한 프로젝트에서만

# B. Claude Code 플러그인 (툴킷은 위 1번으로 먼저 설치)
claude plugin marketplace add ParkBeomsoo/beom-oss-analyzer
claude plugin install beom-oss-analyzer@beom-oss-analyzer
  • 스킬은 설치한 사본에 버전을 남겨, 툴킷이 업데이트되면 doctor 가 outdated 로 알려 줍니다.

  • 같은 이름의 스킬을 직접 만들어 두었거나 다른 설치를 가리키는 MCP 등록이 있으면 덮어쓰지 않고 알려 줍니다.

  • MCP 없이 CLI 만 써도 됩니다. 승인·완료 판정 같은 규칙은 CLI 에서도 똑같이 동작합니다.

업데이트와 제거

pipx upgrade oss-analyzer
oss-analyzer setup --update                      # 이미 설치한 스킬만 새 버전으로 (새로 설치하지 않음)
oss-analyzer setup --remove skill mcp-register   # 이 툴킷이 설치·등록한 것만 되돌림
pipx uninstall oss-analyzer

빠른 시작 ① 저장소 전수 분석

AI 에이전트에게 맡길 때 — Claude Code 에서:

이 저장소 전수 분석해줘 https://github.com/<조직>/<저장소>

스킬이 아래 절차를 따라 진행하고, 큰 저장소는 서브에이전트 여러 개가 단위를 나눠 병렬로 분석합니다.

CLI 로 직접 할 때

oss-analyzer open https://github.com/<조직>/<저장소> --ref v1.2.0   # 분석 전용 clone, 커밋 고정 → project_id
oss-analyzer inventory <pid>                    # 파일 분류·심볼·구조 지도·진입점·분석 단위
oss-analyzer features <pid>                     # 실제 URL·CLI 진입점 목록

# 분석 루프 (단위가 없을 때까지 반복)
oss-analyzer next <pid> --agent a1              # 다음 단위 받기
oss-analyzer context <pid> <unit_id> --agent a1 --raw
oss-analyzer finding <pid> <unit_id> --agent a1 --json finding.json   # 결론 + 근거
oss-analyzer unknown-add <pid> --agent a1 --json unknown.json        # 확정 못 한 것
oss-analyzer complete <pid> <unit_id> --agent a1 --summary "이 단위가 하는 일"

oss-analyzer coverage <pid>                     # 파일·심볼 2축 완료율과 실패 항목
oss-analyzer unknowns <pid>                     # 남은 미확인
oss-analyzer export <pid>                       # Markdown + JSON 리포트

finding.json 예:

{"text": "주문 생성 시 재고를 먼저 잠그고 결제 실패 시 해제한다", "severity": "important",
 "evidence": [{"path": "src/order/service.rs", "start_line": 120, "end_line": 158}],
 "symbol_ids": ["s_1a2b3c"]}

빠른 시작 ② 기능 옮기기와 검증

예: 원본의 POST /api/v1/orders 를 내 저장소에 다른 언어로 옮기는 경우.

# 1. 옮길 범위 보기 → 포팅 원장 만들기
oss-analyzer slice <pid> "POST /api/v1/orders"
oss-analyzer port-create <pid> --name 주문 --targets "POST /api/v1/orders" --language javascript --target-root <내 저장소>

# 2. 원본 응답 저장 (골든) — 원본은 컨테이너에서 격리 실행
oss-analyzer port-capture <pid> <port_id> --cases cases.json \
    --source-image <원본 실행 이미지> --source-url http://127.0.0.1:18001 --source-cmd "<원본 서버 실행 명령>" \
    --coverage-cmd "<커버리지 리포트 생성 명령>" --coverage-report cov.json --explore 40

# 3. 내 코드 작성 → 항목마다 어디로 옮겼는지 기록
oss-analyzer port-map <pid> <port_id> --json map.json

# 4. 비교 검증 (동시 요청까지)
oss-analyzer port-verify <pid> <port_id> --target-url http://127.0.0.1:18002 --target-cmd "node server.js" --concurrency 8

# 5. 진행 상황과 다음 할 일
oss-analyzer port-status <pid> <port_id>

# 6. 사람 승인 — 사용자가 터미널에서 직접 실행 (에이전트가 대신 실행하면 거부됨)
oss-analyzer port-approve <pid> <port_id>

# 7. 완료 판정 — 게이트 7개가 모두 충족될 때만 발급
oss-analyzer port-finish <pid> <port_id>

map.json 예 — 옮김(ported)은 내 코드의 경로:줄, 대체·생략은 사유가 필요합니다.

[{"item": "s_1a2b3c", "status": "ported", "target": "src/orders/create.js:12"},
 {"item": "s_4d5e6f", "status": "replaced", "note": "원본 큐 대신 기존 메시지 서비스 사용"},
 {"item": "s_7a8b9c", "status": "omitted", "note": "관리자 통계는 이번 범위 밖"}]

옮긴 기능을 바꿔서 가져오기

상황

방법

판정

원본과 같아야 함

케이스만 작성

원본 응답과 비교

일부러 다르게 만듦 (값을 정할 수 있음)

케이스에 expect

원본 대신 기대값과 비교, 기대값은 사람 승인

원본에 없는 새 동작

"new": true + expect

원본은 실행하지 않고 기대값으로 판정

형식만 다르고 값은 못 정함

port-accept --case <이름> --reason "<사유>"

차이 허용 제안 → 사람 승인

기능 일부를 뺌

port-map 에서 omitted + 사유

사람 승인

  • 승인 화면에는 원본 응답과 기대값(또는 실제 차이)이 나란히 나옵니다. 승인 뒤 내용이 바뀌면 다시 승인해야 합니다.

  • 원본을 커버리지로 계측할 수 없으면 port-verify --target-coverage-cmd ... --target-coverage-report lcov.info 로 내 코드 쪽 실행 범위를 잽니다.

  • 내 코드를 고쳐 줄이 밀리면 port-map --follow 로 옮긴 위치를 갱신합니다.

원본을 고쳐 쓰는 경우 (커스텀)

oss-analyzer extpoints <pid>                                  # 코어를 안 건드리고 끼울 수 있는 곳 먼저
oss-analyzer impact <pid> pricing.calc_total --verify         # 바꾸면 영향받는 진입점·테스트·결론
oss-analyzer custom-add <pid> --description "할인 계산 변경" --kind modify --targets pricing.calc_total

# 원본 새 버전이 나오면
oss-analyzer open <저장소> --ref v1.3.0 && oss-analyzer inventory <새 pid>
oss-analyzer compare <기준 pid> <새 pid> --save                # 바뀐 곳 + 우리 수정과 부딪히는 곳

고친 원본을 원래 원본과 비교 검증하려면, 고친 저장소를 --target-root 로 두고 빠른 시작 ② 와 같은 방법으로 검증합니다.

케이스 파일 형식

{
  "defaults": {"headers": {"Content-Type": "application/json"}},
  "cases": [
    {"name": "주문생성", "method": "POST", "path": "/api/v1/orders", "json": {"sku": "A1", "qty": 2},
     "match": {"id": "[0-9a-f]{32}"}, "ignore": ["createdAt"]},
    {"name": "주문조회", "method": "GET", "path": "/api/v1/orders/{{주문생성.id}}"},
    {"name": "수량0", "method": "POST", "path": "/api/v1/orders", "json": {"sku": "A1", "qty": 0}, "compare": "status"},
    {"name": "할인적용", "method": "POST", "path": "/api/v1/orders", "json": {"sku": "A1", "qty": 10},
     "expect": {"status": 201, "equals": {"total": 18000}}},
    {"name": "쿠폰_새기능", "new": true, "method": "POST", "path": "/api/v1/orders",
     "json": {"sku": "A1", "qty": 1, "coupon": "WELCOME"}, "expect": {"equals": {"discount": 1000}}}
  ]
}

필드

뜻

method·path·json·headers

HTTP 케이스

argv·stdin

CLI 케이스

call: {source, target}·args·kwargs

함수 단위 비교 (경로:함수명, 언어가 달라도 됨)

{{케이스이름.필드}}

앞 케이스 결과 값 사용 (이름에 공백 없이)

ignore

비교하지 않을 경로 (items.*.t)

match

값 대신 정규식으로 확인 (id·시간처럼 매번 다른 값)

compare: "status"

상태 코드만 비교

expect

원본 대신 기대값과 비교 — status·body·equals(경로: 값, 배열은 items.0.price)·match

new: true

원본에 없는 동작 (expect 필수, 원본에서는 실행 안 함)

explore: false·concurrent: false

입력 자동 변형·동시 요청 검사에서 제외

명령 요약

분류

명령

준비

doctor setup open list inventory classify

분석 루프

next claim renew context finding withdraw mark unknown-add unknown-update complete review pending

정밀 확인

lsp(L1) dataflow(L2) runtime-ingest runtime-run runtime-runs(L3)

결과

coverage features units unknowns export license

커스텀

extpoints impact custom-add custom-list custom-update compare

포팅

slice port-create port-map port-capture port-verify port-accept port-status port-approve port-finish

각 명령의 옵션은 oss-analyzer <명령> --help. 모든 명령은 {ok, data, warnings, errors} JSON 을 출력하고, 실패하면 errors[0].recovery 에 해결 방법이 나옵니다. 에이전트용 상세 절차는 스킬 문서(oss-analyze 스킬의 SKILL.md·CLI.md)에 있습니다.

설정

환경 변수

기본값

설명

OSS_ANALYZER_HOME

~/.oss-analyzer

원장·clone·엔진·백업 위치

OSS_ANALYZER_CONTAINER

auto

격리 실행 엔진 auto·docker·wsl·none

OSS_ANALYZER_WSL_DISTRO

oss-sandbox

Windows 에서 쓸 WSL 배포판

OSS_ANALYZER_LEASE_SECONDS

3600

분석 단위 임대 시간

OSS_ANALYZER_UNIT_MAX_LINES / _UNIT_MAX_CHARS

1500 / 45000

분석 단위 크기 상한

OSS_ANALYZER_CONTEXT_MAX_CHARS

24000

context 한 페이지 크기

OSS_ANALYZER_LSP_TIMEOUT_SECONDS / _LSP_IDLE_SECONDS

900 / 600

언어 서버 응답 대기·유휴 종료

OSS_ANALYZER_RULEPACKS

—

추가 진입점 규칙 폴더

OSS_ANALYZER_CBM · _ASTGREP · _JOERN · _JAVA_HOME

자동 탐색

엔진 실행 파일 직접 지정

CLAUDE_CONFIG_DIR

~/.claude

스킬을 설치할 Claude Code 설정 폴더

안전 원칙

  • 분석 대상 코드는 실행하지 않습니다. 언어 서버의 빌드 스크립트·매크로 실행도 끕니다. 실행이 필요한 검증(커버리지·포팅 원본)은 컨테이너(네트워크 차단)에서, 또는 사용자가 신뢰한다고 한 저장소만 임시 사본에서 실행합니다.

  • 비밀 파일은 읽지 않고, 일반 파일 속 비밀값(비밀번호·키·토큰·URL 자격 증명)은 출력할 때 **** 로 가립니다. 실행 환경 변수에서도 토큰·키류는 빼고 넘깁니다.

  • 분석은 전용 clone 의 고정 커밋에서만 합니다. 작업 중인 원본 폴더의 미커밋 변경은 반영되지 않습니다.

  • 포팅의 사람 승인은 MCP 확인 창이나 사용자의 터미널 입력으로만 받습니다.

알려진 한계

한계

대응

차등 검증은 돌려 본 입력만 증명

입력 자동 변형·커버리지로 범위를 넓히고, 남은 범위는 근거의 limitations 에 기록. 성능은 비교하지 않음

커버리지는 "실행됐다"만 증명

어떤 분기·입력인지는 케이스로 따로 확인

이름 기반 호출 관계는 후보

언어 서버(L1)나 실행(L3)으로 확인해야 근거

동적 디스패치·리플렉션·매크로 생성 코드

자동으로 미확인 처리

데이터 흐름 엔진 첫 실행이 느림 (1만 줄 Java 약 15분)

캐시, dataflow --build-only 로 미리 생성

CLI 는 호출마다 언어 서버를 새로 띄움

같은 언어는 프로세스 간 줄 세움. MCP 모드는 서버를 재사용

설정값에 따라 바뀌는 경로

기본값으로 펼치고 미확인으로 표시

로컬 프로그램이라 같은 권한으로 작정하고 기록을 위조하면 막을 수 없음

위조 시도는 게이트 실패로 드러남. 최종 판정은 깨끗한 환경에서 다시 실행 가능

라이선스

사용 허용, 수정 금지 — LICENSE (오픈소스 라이선스가 아닙니다).

  • 수정하지 않은 상태로 설치·사용하는 것은 누구나 가능합니다 (회사 업무·상업적 목적 포함). 툴킷으로 만든 결과물은 사용자의 것입니다.

  • 수정·2차 저작물·수정본 배포·코드 일부를 다른 소프트웨어에 넣는 것은 저작자의 서면 허락이 필요합니다.

  • 개선 제안은 이 저장소의 이슈·풀 리퀘스트로 받습니다.

사용하는 라이브러리·외부 엔진은 각자의 라이선스를 따릅니다 — THIRD_PARTY.md.

Available Tools

31 tools
oss_capabilitiesC

언어별로 쓸 수 있는 엔진과 단위 상한 등급.

Inputs: project_id (required).

oss_claim_reviewB

important/critical 결론의 독립 검토. 작성자와 다른 reviewer id 여야 함. rejected 면 미확인 생성.

Args: verdict: confirmed / rejected

Inputs: note (required), verdict (required), claim_id (required), reviewer (required), +1 more.

oss_claims_pendingC

독립 검토를 기다리는 결론 목록 (critical 먼저).

Inputs: project_id (required), limit.

oss_claim_withdrawB

내가 쓴 결론 철회 (틀렸거나 문장을 고쳐 다시 낸 옛 판본). 완료된 단위도 가능하며 단위 등급을 다시 계산.

Inputs: reason (required), claim_id (required), project_id (required), agent.

oss_dataflow_buildB

데이터 흐름용 CPG 를 만든다 (Joern). 처음 한 번 오래 걸리고 이후엔 캐시. language 생략 시 주 언어.

Inputs: project_id (required), rebuild, language.

oss_dataflow_queryA

값 흐름(L2): 소스(함수 정의 줄 → 매개변수, 또는 호출 줄 → 인자)에서 sink(호출 이름 정규식)까지 흐르는지.

Args: queries: [{"path": "...", "line": 91, "sink": "select.|insert.", "max_flows": 20}] 결과의 evidence_id 는 L2 근거. 흐름 0건은 '흐름 없음'의 증명이 아님 (limitations 참고).

Inputs: queries (required), project_id (required), language.

oss_doctorA

엔진 설치 여부·버전과 설치 안내. languages 를 주면 그 언어의 LSP 만 점검.

Args: languages: 점검할 언어 목록 (예: ["rust", "python"]). 생략 시 지원 언어 전체.

Inputs: languages.

oss_evidence_getC

근거 상세 (제공자·연산·위치·한계).

Inputs: project_id (required), evidence_id (required).

oss_file_classifyB

규칙으로 분류되지 않은(unclassified) 파일 등을 직접 분류. 사유 필수.

Args: category: doc / generated / vendored / secret / binary / asset / code / test reason: 이렇게 분류한 이유

Inputs: paths (required), reason (required), category (required), project_id (required).

oss_finding_recordB

결론을 근거와 함께 기록. 근거 위치는 고정 커밋 기준으로 검증되고, 틀리면 거부된다.

Args: text: 결론 문장 (무엇을 어떻게 하는지) evidence: [{"evidence_id": "ev_..."}] (도구가 만든 근거) 또는 [{"path", "start_line", "end_line"}] (직접 읽은 위치) symbol_ids: 이 결론이 설명하는 심볼 id 들 (oss_unit_context 의 symbols[].id) — 검토 완료로 표시됨 severity: info / important / critical (important 이상은 독립 검토 필요)

Inputs: text (required), unit_id (required), evidence (required), project_id (required), +4 more.

oss_graph_queryC

구조 지도 읽기 전용 Cypher 질의 (codebase-memory-mcp). 이름 기반 해석이라 L0.

Inputs: cypher (required), project_id (required), max_rows.

oss_inventory_buildA

고정 커밋의 전 파일 분류 + 구조 지도 인덱싱 + 심볼 전수 배정 + 단위 분할 + 진입점 수집. 엔진이 못 본 곳(파싱 실패·규칙팩 없는 프레임워크·동적 경로·바이너리)은 미확인으로 자동 등록.

Args: project_id: oss_repo_open 이 돌려준 id rebuild: 다시 만들기 (진행 중·완료 단위가 있으면 거부)

Inputs: project_id (required), rebuild.

oss_lsp_call_hierarchyB

호출 계층 (LSP callHierarchy). direction: incoming(누가 부르나) / outgoing(무엇을 부르나). L1 근거로 기록됨.

Args: line, column: 함수 이름 위치 (1부터)

Inputs: line (required), path (required), column (required), project_id (required), +1 more.

oss_lsp_definitionC

심볼 정의 위치 (LSP). 결과는 L1 근거로 기록됨.

Inputs: line (required), path (required), column (required), project_id (required).

oss_lsp_referencesC

심볼 참조 위치 전체 (LSP). 줄·열은 1부터. 결과는 L1 근거로 기록됨.

Inputs: line (required), path (required), column (required), project_id (required).

oss_repo_closeB

언어 서버와 DB 연결을 닫는다. 원장·clone 은 지우지 않음 (다음에 이어서 분석 가능).

Inputs: project_id (required).

oss_repo_listC

열어 둔 프로젝트 목록.

Inputs: no named parameters.

oss_repo_openA

분석할 저장소를 열고 커밋을 고정한다. 분석 전용 clone 을 만들어 원본 작업 트리와 분리.

Args: source: 로컬 경로 또는 git URL ref: 고정할 브랜치·태그·커밋 (생략 시 HEAD) name: 프로젝트 이름 (생략 시 저장소 이름). 실제 id 는 -<커밋 앞 8자리>

Inputs: source (required), ref, name.

oss_report_coverageC

2축(파일·심볼) 커버리지와 완료 조건(gates). complete=true 여야 '전수 분석 완료'.

Inputs: project_id (required).

oss_report_exportC

리포트를 Markdown + JSON 으로 내보낸다. 경로를 돌려줌.

Inputs: project_id (required).

oss_report_featuresD

기능 카탈로그 (진입점: http / http-mount / cli / main / scheduler / listener / background-task).

Inputs: project_id (required), limit, offset.

oss_repo_statusC

프로젝트 메타데이터(원본·커밋·인벤토리 시각·엔진 능력).

Inputs: project_id (required).

oss_symbols_markC

결론으로 남길 만한 동작이 없는 심볼(단순 getter·DTO 필드 묶음 등)을 사유와 함께 검토 완료 처리.

Inputs: note (required), unit_id (required), project_id (required), symbol_ids (required), +1 more.

oss_unit_completeC

단위 완료. 검토 안 된 심볼이 있으면 거부(누락 목록 반환). 목표 등급 미달이면 미확인 자동 생성.

Inputs: summary (required), unit_id (required), project_id (required), agent.

oss_unit_contextB

단위 코드(줄 번호 포함)·심볼 목록·호출 간선(L0 근거 id 포함). 코드가 크면 next_offset 으로 이어 읽기.

offset 은 '단위 안의 줄 순번'(next_line 이 파일:줄). 심볼·간선은 첫 페이지에만. 신뢰도 0.5 미만 간선은 all_calls=true 일 때만.

Inputs: unit_id (required), project_id (required), agent, offset, +2 more.

oss_unit_nextB

다음 분석 단위를 임대한다. 이미 임대한 단위가 있으면 그것을 돌려줌. 병렬 분석 시 agent 를 서로 다르게.

Args: agent: 분석하는 에이전트 id (서브에이전트마다 다르게) kind: code / asset / test 중 하나로 제한 (선택)

Inputs: project_id (required), kind, agent.

oss_unit_renewC

임대 연장 (도구 호출마다 자동 연장되지만, 오래 생각만 할 때 명시적으로).

Inputs: unit_id (required), project_id (required), agent.

oss_units_listC

단위 목록 (status: pending / in_progress / done).

Inputs: project_id (required), limit, offset, status.

oss_unknown_recordB

확정하지 못한 것을 미확인으로 기록. 같은 질문·범위는 중복 생성되지 않음.

Args: domain: 예) dataflow / dynamic-dispatch / config / entrypoint / external-dependency severity: low / medium / high / critical required_level: 해결에 필요한 최소 근거 등급 (L0~L3) recommended_probes: [{"operation": "...", "rationale": "..."}]

Inputs: domain (required), question (required), project_id (required), agent, +5 more.

oss_unknowns_listC

미확인 목록 (심각도순, 페이징).

Inputs: project_id (required), limit, domain, offset, +2 more.

oss_unknown_updateB

미확인 갱신·해결. 해결(resolution.disposition=verified)은 required_level 이상 근거가 있어야 함.

Args: expected_revision: 마지막으로 읽은 revision (다르면 revision_conflict) resolution: {"disposition": "verified"|"withdrawn"|"out-of-scope", "rationale": "...", "evidence_ids": [...]}

Inputs: project_id (required), unknown_id (required), expected_revision (required), note, +5 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.8/5.0

    Scored across 31 tools

    Disambiguation4/5

    Most tools have clearly distinct targets and actions: repo lifecycle, LSP operations, dataflow build/query, unit leasing, findings, claims, unknowns, and reports are all separable. A few pairs could be confused, such as oss_unit_complete vs oss_symbols_mark (both mark work as reviewed) and oss_unknown_update vs oss_claim_withdraw (both resolve records), but the descriptions differentiate them.

    Naming Consistency4/5

    A strong oss_<resource>_<verb> pattern is used throughout (oss_repo_open, oss_unit_next, oss_finding_record, oss_claim_review). Minor deviations exist: noun-only tools like oss_capabilities and oss_doctor, plus singular/plural oscillation between oss_unknown_record and oss_unknowns_list, and oss_unit_next vs oss_units_list.

    Tool Count3/5

    31 tools is heavy and sits at the upper boundary where the surface starts to feel fragmented across evidence, claims, unknowns, and units. The multi-stage audit workflow justifies much of it, but several groups (claim review/withdraw/pending, unknown record/update/list) could be consolidated without losing capability.

    Completeness5/5

    The surface covers the full lifecycle: repo open/list/status/close, inventory build, unit leasing and context, symbol marking, finding recording, independent review, unknown tracking, coverage/features/export reports, plus LSP and dataflow engines and a doctor/capabilities check. There are no obvious dead ends for the stated deep-audit purpose.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that extracts complete knowledge from any codebase — architecture, patterns, dependencies, API surface. Combines static analysis with AI-powered deep interpretation.
      8
      MIT
    • F
      license
      B
      quality
      C
      maintenance
      Enables AI agents to perform comprehensive, zero-infrastructure codebase analysis through 24 MCP tools, covering security, quality, architecture, type safety, git history, and dead code detection with high precision and local privacy.
      45
      -