aiarchitect-blog-mcp

AI아키텍트 블로그 MCP 서버

aiarchitect.tistory.com 의 공개 기술 블로그(현재 번들 69편 규모)를 MCP(Model Context Protocol) 도구로 노출합니다. Claude·Cursor 등 MCP 클라이언트에 붙이면 AI 에이전트가 MCP·AI Agent·엔터프라이즈 아키텍처·보안·RAG/LLM 주제의 한국어 장문 기술 글을 바로 검색·열람할 수 있습니다.

💡 목록·검색·본문 응답에 원문(정식 게시글) URL이 실려, 에이전트의 답변에 출처 링크가 남을 가능성을 높입니다(추천 유입). ※ 정식 게시 URL이 없는 글은 fail-closed로 목록·검색·본문에서 제외되어, 홈 URL 폴백이 오도성 출처 링크로 노출되지 않습니다(현재 번들 69편 전부 정식 게시글).

🔒 읽기 전용 서버: 5개 도구 모두 로컬 번들 코퍼스만 읽습니다(쓰기·외부 호출·부작용 없음). 각 도구에 readOnlyHint가 선언돼 있고, limit/offset 등 입력은 범위 밖 값·잘못된 타입을 방어적으로 클램프합니다.

🔧 제공 도구

🚀 설치

Claude Code

claude mcp add aiarchitect-blog -- uvx aiarchitect-blog-mcp

Claude Desktop / Cursor (mcp.json)

{
  "mcpServers": {
    "aiarchitect-blog": {
      "command": "uvx",
      "args": ["aiarchitect-blog-mcp"]
    }
  }
}

uvx가 없으면 uv를 설치하거나 pipx run aiarchitect-blog-mcp 를 사용하세요.

🛠️ 로컬 개발

uv sync                              # 의존성 설치
uv run python scripts/build_index.py /path/to/blogs  # 블로그 md → data/articles_index.json + 본문 번들
uv run pytest -q                     # 파서·검색 골든 테스트
uv run aiarchitect-blog-mcp          # stdio 서버 실행

build_index.py는 소스 블로그 마크다운 디렉터리(파일명 형식 NN-*.md)를 인자로 받습니다: uv run python scripts/build_index.py /path/to/blogs.

📚 다루는 주제

MCP 설계·OAuth 2.1·원격 MCP · AI Agent 보안/감사 · RAG·STT·화자분리 · 멀티플랫폼 SDK 아키텍처 · 골든 테스트·시크릿 가드 등. 전체 목록은 블로그에서 확인하세요.

📄 라이선스

패키지 SPDX 표현식: MIT AND LicenseRef-AIArchitect-Articles

• 코드(SOURCE CODE): MIT — 자세한 내용은 LICENSE.
• 번들된 글 본문: 별도 커스텀 라이선스 LicenseRef-AIArchitect-Articles — 저작권은 원저자(AI아키텍트)에게 있으며, 본 패키지의 일부로서만 원문 그대로 재배포·열람이 허용됩니다. 분리 재배포·2차 저작·상업적 재이용은 원저자의 사전 허가가 필요합니다. 자세한 조건은 LICENSE-ARTICLES.

각 글은 https://aiarchitect.tistory.com/ 의 공개 원문을 편의상 재노출하며, 원문 페이지가 정본입니다.