{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_fv773gtts2cs","handle":"shillok-mcp","url":"https://wellknown.network/agents/shillok-mcp","links":{"self":"https://wellknown.network/agents/shillok-mcp/record.json","html":"https://wellknown.network/agents/shillok-mcp","markdown":"https://wellknown.network/agents/shillok-mcp/record.md","api":"https://wellknown.network/api/v1/agents/shillok-mcp","status":"https://wellknown.network/api/v1/agents/shillok-mcp/status","claim":"https://wellknown.network/agents/shillok-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/shillok-mcp/claim.json","badge":"https://wellknown.network/agents/shillok-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/shillok-mcp/history","tools":"https://wellknown.network/api/v1/agents/shillok-mcp/tools"},"ard":{"identifier":"urn:air::server:shillok-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"shillok-mcp","summary":"Shillok MCP server — stdio wrapper over the REST API","description":"# shillok-mcp\n\nShillok(실록) REST API를 감싸는 stdio MCP 서버.\n프로젝트/태스크/위키(+파일 첨부)/브레인덤프/타임라인 블록/우선순위/주간 목표를 LLM 툴로 노출한다.\n`upload_wiki_attachment(page_id, file_path)` 로 로컬 파일을 위키 페이지에 첨부할 수 있다(object storage).\n\n## 설치 (PyPI)\n\nrepo 클론 없이 설치할 수 있다.\n\n```bash\nuvx shillok-mcp          # 일회 실행(권장)\n# 또는\npip install shillok-mcp  # 영구 설치 → `shillok-mcp` 명령\n```\n\n## 준비\n\n1. 웹 설정 화면 → **API 토큰** → 토큰 발급 (`tbx_...`, 발급 직후 한 번만 표시).\n2. `cd apps/mcp && uv sync`\n\n## 등록 (Claude Code)\n\n```bash\nclaude mcp add shillok \\\n  --env SHILLOK_API_URL=http://localhost:8000 \\\n  --env SHILLOK_API_TOKEN=tbx_... \\\n  -- uvx shillok-mcp\n```\n\n또는 `.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"shillok\": {\n      \"command\": \"uvx\",\n      \"args\": [\"shillok-mcp\"],\n      \"env\": {\n        \"SHILLOK_API_URL\": \"http://localhost:8000\",\n        \"SHILLOK_API_TOKEN\": \"tbx_...\",\n        \"SHILLOK_DEFAULT_PROJECT\": \"652f...\"\n      }\n    }\n  }\n}\n```\n\n로컬 개발/미게시 버전:\n\n```bash\nuv run --directory /path/to/timebox-planner/apps/mcp shillok-mcp\n```\n\n⚠️ 실제 토큰이 든 `.mcp.json`은 커밋하지 마세요 — 개인 설정(`~/.claude.json` 또는 `claude mcp add`)을 사용하세요.\n\n- `SHILLOK_API_URL` — API 서버 주소 (기본 `http://localhost:8000`)\n- `SHILLOK_API_TOKEN` — 필수. 개인 API 토큰\n- `SHILLOK_DEFAULT_PROJECT` — 선택. 주로 보는 프로젝트의 고유 ID. 설정하면 프로젝트 인자를 생략한 태스크/위키 툴이 이 프로젝트로 기본 동작한다. ID는 웹 **프로젝트 설정 → 프로젝트 ID**에서 복사(`get_default_project` 툴로 확인).\n- `SHILLOK_WEB_URL` — 선택. 위키 툴 출력의 `link`(및 공개 페이지 `public_link`)를 만들 웹 앱 주소. API 주소와 다르다. 기본 `https://shillok.com`.\n\n## 스모크 테스트\n\n```bash\nSHILLOK_API_TOKEN=tbx_... uv run python -c \\\n  \"from shillok_mcp.client import ShillokClient; print(ShillokClient().request('GET', '/projects'))\"\n```\n\n## 릴리스 (PyPI 게시)\n\n`mcp-v*` 태그를 push하면 `.github/workflows/mcp-release.yml`이 검증 후 PyPI에 게시한다.\n\n1. `apps/mcp/pyproject.toml`의 `version`을 올린다 (예: `0.1.0` → `0.2.0`).\n2. 커밋 후 태그를 버전과 **정확히 일치**시켜 push:\n   ```bash\n   git commit -am \"chore(mcp): bump version to 0.2.0\"\n   git tag mcp-v0.2.0\n   git push origin mcp-v0.2.0\n   ```\n3. 워크플로가 ruff/mypy/pytest → 버전 일치 확인 → `uv buil…","publisher":{"name":"dchain-enterprise","url":null},"homepage":null,"repository":"https://github.com/dchain-enterprise/timebox-planner","version":"0.2.0","license":"Proprietary","protocols":["mcp"],"tags":["llm","mcp","shillok","stdio"],"pricing":null,"endpoints":[{"url":"pypi:shillok-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"shillok-mcp","registry":"pypi","observedAt":"2026-11-04T00:27:36.148Z","publishedAt":"2026-08-07T09:07:45.101172Z","latestVersion":"0.2.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"shillok-mcp","url":"https://pypi.org/project/shillok-mcp/","firstSeenAt":"2026-09-10T12:21:55.536Z","fetchedAt":"2026-11-04T00:26:37.680Z","normalizedAt":"2026-11-04T00:26:37.680Z"}]},"firstSeenAt":"2026-09-10T12:21:55.536Z","updatedAt":"2026-11-04T00:27:36.148Z"}