@twkim_sim/llmops-mcp

Nubison LLM 플랫폼(llmops)의 검색·문서 다운로드를 MCP 도구로 내는 stdio MCP 서버다. 에이전트 런타임(Claude Code / Codex)이 세션마다 자식 프로세스로 띄우며 포트를 열지 않는다.

도구

| 도구 | 하는 일 | |---|---| | list_documents | collection_id 의 문서 목록 (id, file_name, doc_type, page_count, size_bytes). 선택 query 로 파일명 필터 | | download_document | document_id 원본 파일을 작업 디렉터리에 저장하고 경로·크기·content type 반환 |

흐름은 둘이다: 컬렉션 id 로 문서를 고르고, 그 문서 id 로 내려받는다.

환경변수

| 이름 | 필수 | 뜻 | |---|---|---| | NUBISON_BASE_URL | 예 | llmops REST 주소. 클러스터 안에서는 http://llmplatform-backend.llmplatform.svc.cluster.local:8000 | | NUBISON_AUTH_DATA | 예 | {"userId","tenantId"} 를 base64 한 값. X-AuthData 헤더로 실린다 |

값은 도구 응답에 되돌려 주지 않는다.

Studio 에서 붙이기

순서가 있다. env 이름은 JSON 으로 넘길 수 없고(가져오기가 type/command/args/url 만 받는다), 가져온 뒤 MCP 행에서 지정한다.

1. Environment 에 두 행이 있어야 한다. NUBISON_AUTH_DATA 는 소유자 Draft 에 Secret 행으로 자동 생성돼 있고, NUBISON_BASE_URL 은 일반 행으로 직접 추가한다: NUBISON_BASE_URL = http://llmplatform-backend.llmplatform.svc.cluster.local:8000 (없으면 검증이 mcp_environment_missing 으로 막는다.)

2. MCP → JSON 가져오기:

   { "mcpServers": { "nubison-llmops": { "command": "npx", "args": ["-y", "@twkim_sim/[email protected]"] } } }

   가져오기 단계에서 Runner 가 실제로 패키지를 받아 띄우고 list_documents, download_document 두 도구를 나열한다.

3. 가져온 MCP 행을 열어 허용할 Env 이름 (쉼표 구분) 칸에 NUBISON_BASE_URL, NUBISON_AUTH_DATA 를 적는다. 렌더러가 Claude 는 .mcp.json 의 env 로, Codex 는 config.toml 의 env_vars 로 옮겨 MCP 프로세스에 넘긴다.

버전은 반드시 고정한다. 새 Runner Pod 은 세션마다 패키지를 내려받는다.

로컬 확인

cd mcp/llmops-mcp
npm install
npm run smoke          # initialize → tools/list 핸드셰이크만 확인

배포(publish)

npm login              # 브라우저 로그인
npm publish --access public

스코프(@simplatform)는 npm 조직 또는 사용자 이름과 같아야 한다.