Skip to main content
Glama
aiarchitect-blog-mcp

aiarchitect-blog-mcp

Official

AI아키텍트 블로그 MCP 서버

CI

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

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

🔤 영문으로 물어도 한글로만 쓴 글에 닿습니다. 글 본문은 같은 개념을 영문("observability")과 한글("관측성")로 번갈아 씁니다. 검색은 두 표기를 하나의 개념으로 묶어 세므로, 어느 쪽으로 물어도 결과와 순위가 같습니다(수록 기준·측정: scripts/synonym_report.py).

🔡 붙여 쓴 한글 복합어도 받습니다. 글이 검색 증강 생성으로 써도 검색증강생성으로 물으면 찾습니다.

📎 여러 낱말로 물으면 붙어 있는 쌍을 구(句)로도 셉니다. 감사 로그로 물으면 그 구를 통째로 담은 글이 먼저 옵니다 — 감사와 로그가 따로 흩어진 글보다 위입니다. 구는 거르지 않고 더하기만 하므로, 낱말만 맞는 글도 뒤에 그대로 남습니다.

🖼️ 도식은 캡션으로 들어갑니다. 글의 그림은 본문 안에서 열리지 않습니다 — 원문 페이지가 쓰는 이미지 주소는 서명과 만료 시각이 붙어 있어 번들에 담아 둘 수 없기 때문입니다. 그래서 열리지 않는 링크 대신 그림 설명을 한 줄 캡션으로 남깁니다. 도식이 무엇을 보여 주는지는 그대로 읽히고, 깨진 이미지 문법이 에이전트 답변에 섞이지 않습니다. 원본 그림은 각 응답에 실리는 원문 URL에서 볼 수 있습니다.

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

설계와 공개 배포 과정은 다음 글에 정리했습니다.

🔧 제공 도구

도구

설명

list_categories()

분류(7종)와 각 편수

list_articles(category?, limit?, offset?)

글 목록(분류 필터·페이지네이션)

search_articles(query, category?, limit?)

제목·설명·태그·본문 검색(BM25 랭킹·구 매칭·영↔한 동의어·띄어쓰기 흡수·스니펫)

get_article(article_id)

전체 본문(게시용 목차·인라인 CSS·HTML 주석·죽은 이미지 링크를 걷어낸 마크다운) + 원문 URL(출처 링크)

blog_home()

블로그 홈 URL·제공 편수

Related MCP server: viruagent-mcp

🚀 설치

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 python scripts/synonym_report.py  # 동의어 사전 ↔ 코퍼스 측정(수록 기준 재확인)
uv build && uv run python scripts/verify_dist.py dist/   # 배포 산출물 검증
uv run aiarchitect-blog-mcp          # stdio 서버 실행

build_index.py는 소스 블로그 마크다운 디렉터리(파일명 형식 NN-*.md, 글 번호 1~3자리)를 인자로 받습니다: uv run python scripts/build_index.py /path/to/blogs. 글의 article_id는 원문 글 번호와 같습니다(get_article("100") → .../100).

verify_dist.py는 wheel·sdist 안쪽을 열어 본문·인덱스 편수와 정합성을 확인합니다. 서빙 코드가 멀쩡해도 데이터 번들이 빠진 wheel은 설치한 쪽에서만 깨지기 때문입니다. --installed를 주면 설치된 패키지만으로 코퍼스·검색·본문이 동작하는지 검사합니다(저장소 밖에서 실행).

📚 다루는 주제

MCP 설계·OAuth 2.1·원격 MCP · AI Agent 보안/감사 · RAG·STT·화자분리 · 멀티플랫폼 SDK 아키텍처 · 골든 테스트·시크릿 가드 · AI Agent 관측성·평가·컨트롤 플레인 · A2A 오케스트레이션·위임 인가 · SRE/FinOps·용량 산정·릴리스 거버넌스·Assurance Case 등. 전체 목록은 블로그에서 확인하세요.

📄 라이선스

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

  • 코드(SOURCE CODE): MIT — 자세한 내용은 LICENSE.

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

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

Available Tools

5 tools
blog_homeA
Read-onlyIdempotent

블로그 홈 URL과 서버가 제공하는 글 편수를 반환한다.

Inputs: no named parameters. Returns: result

get_articleA
Read-onlyIdempotent

글 ID로 전체 본문(마크다운)을 반환한다. 상단·하단에 원문 URL 백링크를 포함한다.

Inputs: article_id (required). Returns: result

list_articlesB
Read-onlyIdempotent

글 목록을 반환한다.

Inputs: limit, offset, category. Returns: result

list_categoriesA
Read-onlyIdempotent

블로그 분류(카테고리)와 각 분류의 글 편수를 반환한다.

Inputs: no named parameters. Returns: result

search_articlesA
Read-onlyIdempotent

제목·설명·태그·본문에서 query를 검색해 관련 글을 랭킹순으로 반환한다.

각 결과는 id/제목/분류/태그/원문 URL/스니펫을 포함한다.

Inputs: query (required), limit, category. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clear, distinct purpose: list categories, list articles, search articles, fetch a single article, and get home info. There is no overlap or ambiguity between them.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern: list_categories, list_articles, search_articles, get_article. blog_home is a slight deviation but still clear and predictable.

    Tool Count5/5

    With 5 tools, the set is well-scoped for a blog reading API. Each tool provides essential functionality without redundancy or bloat.

    Completeness4/5

    The surface covers core blog browsing needs: categories, article listing, search, and full-text retrieval. A possible gap is filtering articles by category directly, but this is a minor workaround.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers