Skip to content

feat: 코딩 에이전트용 MCP·직접 도구 CLI 연결부 추가 - #259

Open
seyoung4503 wants to merge 2 commits into
masterfrom
feature/mcp-tool-adapter
Open

seyoung4503 wants to merge 2 commits into
masterfrom
feature/mcp-tool-adapter

Conversation

@seyoung4503

@seyoung4503 seyoung4503 commented Nov 14, 2026 •

Copy link
Copy Markdown
Collaborator

#️⃣ Issue Number

  • 별도 연결 이슈 없음. 요청된 MCP 연결부를 독립 PR로 구현했습니다.

📝 요약(Summary)

  • Codex/Claude Code가 기존 Lang2SQL 도구를 호출할 수 있는 선택적 stdio MCP 서버(lang2sql-mcp)와 직접 도구 CLI(lang2sql-tools)를 추가합니다. 코딩 에이전트가 대화를 담당하며 내부 agent_loop나 LLM provider는 실행하지 않습니다.
  • 기존 ToolSpec, ToolRegistry, ToolResult, SQL safety/DB explorer, federation, memory service를 재사용합니다. 기존 CLI/Discord·core ports·도구 구현은 변경하지 않습니다.
  • run_sql, explore_schema, term_custom, remember, recall_memory를 제공하며 설치·클라이언트 등록·제한 사항은 docs/mcp.md와 docs/tool_cli.md에 설명했습니다.

💬 To Reviewers

  • HarnessContext를 그대로 조립합니다. session은 비어 있고 내부 LLM은 호출 시 오류를 내므로 하네스 구조를 재설계하지 않습니다. 기억 조회만 기존 서비스 위의 작은 도구로 추가했습니다. MCP와 CLI가 tenancy/tool_runtime.py를 공유합니다.

  • 서버 한 개당 운영자가 정한 DB/사용자/조직/팀을 사용합니다. 모델 인자로 identity/admin을 바꿀 수 없습니다. 메타데이터 쓰기는 기존 권한을 유지합니다.

  • 자동 system-prompt 주입은 실행되지 않으므로 클라이언트에 term_custom(list=true)/recall_memory 사용을 안내합니다. 내부 LLM·문서 확인 흐름에 의존하는 도구는 노출하지 않습니다.

  • SQL 결과는 기존 텍스트 형식이며 50행까지 표시합니다. 기억은 프로세스 메모리라 재시작하면 사라지고, 업무 정의/감사 로그만 --store로 지속됩니다. 실험용 그래프/별칭 검사 코드는 포함하지 않았습니다.

  • stdio 실제 연결 테스트는 Python MCP client로 수행했습니다. Codex/Claude 등록 명령 형식은 각 로컬 CLI help로 확인했으며 실제 사용자 클라이언트 설정은 변경하지 않았습니다.

  • 새 테스트 workflow는 Python 3.10/3.13에서 MCP extra를 설치해 전체 테스트를 실행합니다. 로컬 검증은 Python 3.13입니다.

  • 직접 CLI는 list, call, batch, JSON 인자 파일/stdin, JSON 출력 및 종료 코드(0/1/2)를 지원합니다. batch는 전체 입력 검증 후 순차 실행하고 첫 도구 오류에서 중단합니다. 앞선 메타데이터 쓰기는 롤백하지 않습니다.

  • tools extra만 설치한 격리 환경에서 CLI 진입점을 확인했습니다. CLI subprocess SQL·실패 코드·기억 batch·실행 전 검증 테스트를 포함합니다.

  • Oracle 지원 PR #257은 아직 승인 대기 중입니다. 이 PR은 Oracle 수정 코드를 중복 구현하지 않습니다.

Validation

  • 전체 pytest: 171 passed (실제 subprocess stdio handshake/list/call, SQL 실행·DDL 차단, 오류/추가 인자 차단, 팀 범위·권한, 저장소 재시작 검증 포함).
  • 변경 범위 Ruff 통과, 프로젝트 전체 Black 26.1.0 107개 파일 통과, 변경 소스 4개 mypy 통과, git diff --check 통과.
  • 기존 bench/ecommerce_demo.py exit 0. 이 데모는 기존 canned DB/FakeLLM을 사용하며 MCP 정확도 평가가 아닙니다.
  • 기존 MemoryService·ToolRegistry·SQL safety·DB explorer·federation 재사용. 신규 운영 Python 코드 363줄. lockfile은 optional MCP SDK 의존성 추가로 갱신했습니다.

구현 원칙 검증

항목 판정 근거
재사용 O 기존 schema/dispatch/SQL/정의/기억 서비스 사용
원인 대응 O transport·조립·조회 노출만 추가
로깅 O stderr에 tool/call ID 및 성공·실패 기록
오류 처리 O 기존 오류 내용을 MCP isError로 전달, 내부 LLM 호출 금지
설정 주입 O 시작 인자 및 기존 DB 환경설정 조립 경로 재사용
이슈번호 주석 O 신규 코드에 없음
검증 O pytest·Ruff·Black·mypy 통과; CODE MAP 도구 없음
승인 범위 O PR까지만, 병합·배포 없음
호출 연결 O MCP→registry→기존 도구를 실제 stdio로 검증
sync/async O 단일 dispatch를 worker에 위임, 공유 SQLite 접근 직렬화
설정·배포 O 신설 env 0; CLI 옵션 문서화; 로컬 stdio라 배포 구성 없음

PR Checklist

  • 변경 사항에 대한 테스트 또는 검증 완료
  • 로컬에서 정상 동작 확인
  • 관련 문서 업데이트 완료

@seyoung4503 seyoung4503 changed the title feat: 코딩 에이전트용 stdio MCP 도구 연결부 추가 feat: 코딩 에이전트용 MCP·직접 도구 CLI 연결부 추가 Nov 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant