oss-analyzer
This server is an MCP interface to the oss-analyzer toolkit: it opens a repository at a pinned commit, exhaustively analyzes it unit-by-unit with evidence grading, records findings and unknowns, and exports coverage/feature reports.
Repo management —
oss_repo_openclones a repo at a fixed ref into an isolated analysis copy, plusoss_repo_list,oss_repo_status,oss_repo_close.Environment check —
oss_doctorreports installed engines/versions and setup guidance, optionally per language.Inventory & structure —
oss_inventory_buildclassifies all files, indexes a structural map, assigns every symbol to units, splits units, and collects entry points;oss_capabilitiesshows per-language engines and unit limits.Manual classification —
oss_file_classifycategorizes unclassified files (doc, generated, vendored, secret, binary, asset, code, test) with a required reason.Analysis loop —
oss_units_list,oss_unit_next(leases the next unit, parallel-safe via distinctagent),oss_unit_context(paged code with line numbers, symbols, call edges),oss_unit_renew,oss_unit_complete(rejects if symbols unreviewed).Findings & claims —
oss_finding_recordlogs conclusions with validated file:line evidence and severity;oss_symbols_markmarks trivial symbols done;oss_claim_review(independent reviewer for important/critical),oss_claim_withdraw,oss_claims_pending.Unknown tracking —
oss_unknown_record,oss_unknown_update(revision-checked, resolution needs sufficient evidence),oss_unknowns_list;oss_evidence_getinspects evidence provenance and limits.Precision checks — LSP tools
oss_lsp_references,oss_lsp_definition,oss_lsp_call_hierarchy(incoming/outgoing) recorded as L1; L2 dataflow viaoss_dataflow_build(Joern CPG, cached) andoss_dataflow_query(source-to-sink flows); L0 read-only Cypher throughoss_graph_query.Reports —
oss_report_coverage(two-axis file/symbol coverage plus completion gates),oss_report_features(HTTP/CLI/scheduler/listener entry-point catalog),oss_report_export(Markdown + JSON).
Supports analyzing Express applications by detecting route entry points and resolving route paths for source-level coverage.
Supports analyzing FastAPI applications by detecting route entry points and resolving route paths.
Supports analyzing Flask applications by detecting route entry points and resolving route paths.
Supports analyzing Gin applications by detecting route entry points and resolving route paths.
Supports analyzing Next.js file-based routing, including route groups, parallel and intercepting routes, and inactive folders.
Supports analyzing Spring applications via rulepack-based entry point detection, identifying HTTP routes and controllers.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@oss-analyzer Analyze this repository exhaustively and catalog every file, symbol, route, and call flow."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
beom-oss-analyzer
오픈소스를 빠짐없이 분석하고, 필요한 기능만 내 저장소로 옮겨 원본과 같은지 검증하는 툴킷
남이 만든 기능을 "대충 읽고 따라 만들기" 대신, 코드 전체를 근거(파일:줄)와 함께 분석하고 옮긴 결과가 원본과 같은 동작인지 프로그램으로 확인합니다. Claude Code 같은 AI 에이전트가 절차를 따라 쓰도록 스킬·MCP 도구·CLI 를 함께 제공하고, AI 가 혼자 정하면 안 되는 일은 사람 승인 없이는 끝나지 않게 막습니다.
목차
Related MCP server: CodeGraph
무엇을 하나
하고 싶은 일 | 툴킷이 하는 일 |
기능을 빠짐없이 파악 | 모든 파일을 분류하고 모든 함수를 검토 단위로 나눠, 결론마다 근거(파일:줄)를 붙입니다. 확정하지 못한 것은 "미확인 목록"으로 남깁니다. |
실제 API 목록 | 프레임워크별 규칙으로 HTTP·CLI 진입점을 찾고, 코드에서 조립되는 URL 까지 펼쳐 실제 경로 목록을 만듭니다. |
고치기 전 영향 확인 | 바꾸려는 함수가 어디에 영향을 주는지(호출자·구현체·진입점·테스트), 코어를 건드리지 않고 끼울 수 있는 확장 포인트가 어디인지 보여 줍니다. |
원본 업데이트 따라가기 | 두 버전을 비교해 우리 수정과 부딪히는 곳(함수 삭제·이름 변경·시그니처 변경)을 찾습니다. |
기능만 골라 옮기기 | 진입점 하나에서 필요한 코드·상태·설정·외부 의존을 잘라 내고, 항목마다 어디로 옮겼는지 원장에 기록합니다. 다른 언어로 다시 만들어도 됩니다. |
옮긴 결과 검증 | 같은 입력을 원본과 내 코드에 넣어 결과를 비교합니다(HTTP·CLI·함수 단위). 일부러 바꾼 동작은 기대값과, 원본에 없는 새 동작도 기대값으로 검증합니다. |
AI 지름길 차단 | 차이 허용·기능 생략·테스트 축소·기대값은 사람 승인 전까지 완료가 안 됩니다. 검증 뒤 코드가 바뀌거나 기록을 툴킷 밖에서 고치면 잡아냅니다. |
핵심 개념
근거 등급 — 결론이 얼마나 확실한지를 등급으로 남깁니다.
등급 | 뜻 | 얻는 방법 |
L0 | 코드를 읽고 구조 지도로 확인 | 기본 |
L1 | 언어 서버로 호출·참조 확인 |
|
L2 | 값이 어디서 어디로 흐르는지 확인 |
|
L3 | 실제로 실행되는 것을 확인 | 커버리지 리포트, 차등 검증 |
원장 — 분석·포팅 상태는 프로젝트별 SQLite 원장(~/.oss-analyzer/projects/<id>/ledger.db)에 쌓입니다.
세션이 바뀌어도, 여러 에이전트가 동시에 일해도 같은 기록을 이어 씁니다.
포팅 완료 조건 (게이트 7개) — 전부 충족해야 port-finish 가 완료 판정을 냅니다.
옮길 항목이 모두 처리됨 (옮김 / 대체 / 생략)
옮긴 위치가 지금도 그대로 있음 (줄 내용까지)
차등 검증 통과 — 마지막으로 저장한 케이스 전부, 지금 코드 기준 (검증 뒤 코드가 바뀌면 무효)
케이스가 옮길 함수를 모두 실행함 (원본 커버리지, 안 되면 내 코드 커버리지)
사람 확인 항목이 모두 승인됨 (차이 허용·생략·케이스 변경·기대값, 승인 뒤 내용이 바뀌면 무효)
기록이 툴킷 밖에서 바뀌지 않음 (원장 해시 사슬·골든 해시)
라이선스 확인이 필요한 파일이 없음
모든 포팅 명령 응답에는 next_step(다음에 할 일)이 붙습니다.
요구 사항
구분 | 내용 |
필수 | Python 3.11+, git |
필수 엔진 | 구조 지도 엔진, 진입점 규칙 엔진 — |
선택 | 언어 서버(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 coveragesetup은 아무 옵션 없이 실행하면 계획만 보여 주고 아무것도 바꾸지 않습니다.--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": "관리자 통계는 이번 범위 밖"}]옮긴 기능을 바꿔서 가져오기
상황 | 방법 | 판정 |
원본과 같아야 함 | 케이스만 작성 | 원본 응답과 비교 |
일부러 다르게 만듦 (값을 정할 수 있음) | 케이스에 | 원본 대신 기대값과 비교, 기대값은 사람 승인 |
원본에 없는 새 동작 |
| 원본은 실행하지 않고 기대값으로 판정 |
형식만 다르고 값은 못 정함 |
| 차이 허용 제안 → 사람 승인 |
기능 일부를 뺌 |
| 사람 승인 |
승인 화면에는 원본 응답과 기대값(또는 실제 차이)이 나란히 나옵니다. 승인 뒤 내용이 바뀌면 다시 승인해야 합니다.
원본을 커버리지로 계측할 수 없으면
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}}}
]
}필드 | 뜻 |
| HTTP 케이스 |
| CLI 케이스 |
| 함수 단위 비교 ( |
| 앞 케이스 결과 값 사용 (이름에 공백 없이) |
| 비교하지 않을 경로 ( |
| 값 대신 정규식으로 확인 (id·시간처럼 매번 다른 값) |
| 상태 코드만 비교 |
| 원본 대신 기대값과 비교 — |
| 원본에 없는 동작 ( |
| 입력 자동 변형·동시 요청 검사에서 제외 |
명령 요약
분류 | 명령 |
준비 |
|
분석 루프 |
|
정밀 확인 |
|
결과 |
|
커스텀 |
|
포팅 |
|
각 명령의 옵션은 oss-analyzer <명령> --help. 모든 명령은 {ok, data, warnings, errors} JSON 을 출력하고,
실패하면 errors[0].recovery 에 해결 방법이 나옵니다. 에이전트용 상세 절차는 스킬 문서(oss-analyze 스킬의 SKILL.md·CLI.md)에 있습니다.
설정
환경 변수 | 기본값 | 설명 |
|
| 원장·clone·엔진·백업 위치 |
|
| 격리 실행 엔진 |
|
| Windows 에서 쓸 WSL 배포판 |
|
| 분석 단위 임대 시간 |
|
| 분석 단위 크기 상한 |
|
|
|
|
| 언어 서버 응답 대기·유휴 종료 |
| — | 추가 진입점 규칙 폴더 |
| 자동 탐색 | 엔진 실행 파일 직접 지정 |
|
| 스킬을 설치할 Claude Code 설정 폴더 |
안전 원칙
분석 대상 코드는 실행하지 않습니다. 언어 서버의 빌드 스크립트·매크로 실행도 끕니다. 실행이 필요한 검증(커버리지·포팅 원본)은 컨테이너(네트워크 차단)에서, 또는 사용자가 신뢰한다고 한 저장소만 임시 사본에서 실행합니다.
비밀 파일은 읽지 않고, 일반 파일 속 비밀값(비밀번호·키·토큰·URL 자격 증명)은 출력할 때
****로 가립니다. 실행 환경 변수에서도 토큰·키류는 빼고 넘깁니다.분석은 전용 clone 의 고정 커밋에서만 합니다. 작업 중인 원본 폴더의 미커밋 변경은 반영되지 않습니다.
포팅의 사람 승인은 MCP 확인 창이나 사용자의 터미널 입력으로만 받습니다.
알려진 한계
한계 | 대응 |
차등 검증은 돌려 본 입력만 증명 | 입력 자동 변형·커버리지로 범위를 넓히고, 남은 범위는 근거의 limitations 에 기록. 성능은 비교하지 않음 |
커버리지는 "실행됐다"만 증명 | 어떤 분기·입력인지는 케이스로 따로 확인 |
이름 기반 호출 관계는 후보 | 언어 서버(L1)나 실행(L3)으로 확인해야 근거 |
동적 디스패치·리플렉션·매크로 생성 코드 | 자동으로 미확인 처리 |
데이터 흐름 엔진 첫 실행이 느림 (1만 줄 Java 약 15분) | 캐시, |
CLI 는 호출마다 언어 서버를 새로 띄움 | 같은 언어는 프로세스 간 줄 세움. MCP 모드는 서버를 재사용 |
설정값에 따라 바뀌는 경로 | 기본값으로 펼치고 미확인으로 표시 |
로컬 프로그램이라 같은 권한으로 작정하고 기록을 위조하면 막을 수 없음 | 위조 시도는 게이트 실패로 드러남. 최종 판정은 깨끗한 환경에서 다시 실행 가능 |
라이선스
사용 허용, 수정 금지 — LICENSE (오픈소스 라이선스가 아닙니다).
수정하지 않은 상태로 설치·사용하는 것은 누구나 가능합니다 (회사 업무·상업적 목적 포함). 툴킷으로 만든 결과물은 사용자의 것입니다.
수정·2차 저작물·수정본 배포·코드 일부를 다른 소프트웨어에 넣는 것은 저작자의 서면 허락이 필요합니다.
개선 제안은 이 저장소의 이슈·풀 리퀘스트로 받습니다.
사용하는 라이브러리·외부 엔진은 각자의 라이선스를 따릅니다 — THIRD_PARTY.md.
Available Tools
31 toolsoss_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
Scored across 31 tools
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.
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.
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.
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
Hosted code graph over MCP: exact callers, dependencies, and cross-repo blast radius for AI agents.
Zero-config MCP security scanner for AI-generated apps. 25K+ vulnerability patterns.
IaC, CI and dependency security review for coding agents: local scan CLI plus hosted OAuth MCP.
10,000+ source-verified compliance nodes, 39 pillars, 25 MCP tools (EU AI Act, GDPR, NIST, MITRE).
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that extracts complete knowledge from any codebase — architecture, patterns, dependencies, API surface. Combines static analysis with AI-powered deep interpretation.8MIT

CodeGraphofficial
AlicenseNot gradedqualityBmaintenanceBuilds a semantic graph of codebases across 38 languages and exposes 42 MCP tools for structured code understanding, search, and impact analysis.162Apache 2.0- FlicenseBqualityCmaintenanceEnables 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-

Celmis MCP Serverofficial
AlicenseNot gradedqualityBmaintenanceEnables querying indexed code across multiple repositories with file-level citations, reviewing pull requests, auditing dependencies, and exporting SBOMs and evidence packs through MCP tools.4AGPL 3.0