aiarchitect-blog-mcp
OfficialA read-only MCP server that exposes a Korean technical blog corpus (94 articles) for browsing, searching, and reading articles with original source URLs.
List blog categories and article counts.
List articles, optionally filtered by category with pagination.
Search titles, descriptions, tags, and full body text with ranked results, Korean/English synonym matching, spacing-tolerant matching, phrase matching, and snippets.
Retrieve a full article in cleaned Markdown by article ID, including original URL backlinks.
Get the blog home URL and the number of articles served.
All tools are read-only: no writes, external calls, or side effects.
Provides tools to search and retrieve articles from the AI Architect blog on Tistory, including listing categories, listing articles, searching, and fetching full article content with original URLs.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@aiarchitect-blog-mcp search articles about MCP and AI agents"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
AI아키텍트 블로그 MCP 서버
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등 입력은 범위 밖 값·잘못된 타입을 방어적으로 클램프합니다.
설계와 공개 배포 과정은 다음 글에 정리했습니다.
🔧 제공 도구
도구 | 설명 |
| 분류(7종)와 각 편수 |
| 글 목록(분류 필터·페이지네이션) |
| 제목·설명·태그·본문 검색(BM25 랭킹·구 매칭·영↔한 동의어·띄어쓰기 흡수·스니펫) |
| 전체 본문(게시용 목차·인라인 CSS·HTML 주석·죽은 이미지 링크를 걷어낸 마크다운) + 원문 URL(출처 링크) |
| 블로그 홈 URL·제공 편수 |
Related MCP server: viruagent-mcp
🚀 설치
Claude Code
claude mcp add aiarchitect-blog -- uvx aiarchitect-blog-mcpClaude 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 toolsblog_homeARead-onlyIdempotent
블로그 홈 URL과 서버가 제공하는 글 편수를 반환한다.
Inputs: no named parameters. Returns: result
get_articleARead-onlyIdempotent
글 ID로 전체 본문(마크다운)을 반환한다. 상단·하단에 원문 URL 백링크를 포함한다.
Inputs: article_id (required). Returns: result
list_articlesBRead-onlyIdempotent
글 목록을 반환한다.
Inputs: limit, offset, category. Returns: result
list_categoriesARead-onlyIdempotent
블로그 분류(카테고리)와 각 분류의 글 편수를 반환한다.
Inputs: no named parameters. Returns: result
search_articlesARead-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
Scored across 5 tools
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.
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.
With 5 tools, the set is well-scoped for a blog reading API. Each tool provides essential functionality without redundancy or bloat.
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
Related MCP Connectors
Read-only MCP tools for AI agent discovery, structured resources, and NIULAI information.
Search MCP servers, agent skills and AI tools by task. Read-only, no API key.
Search and read the Radixia blog (enterprise AI, cloud, open source) via MCP.
Read-only search over 2,065+ AI agent tools and 276 MCP servers. Free, no sign-up needed.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceRead-only MCP server that serves curated daily Korean AI briefings (papers, releases, community, video, deepdive) via 7 tools, with no LLM calls per request.-
- FlicenseBqualityDmaintenanceMCP server that exposes Tistory blog posting functionality, enabling AI agents to write, upload, and publish posts (public/private) via Playwright and Tistory API.9-
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to discover and explore Korean community boards, search posts, and read post content and comments through a read-only MCP interface.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to read articles, search site archives, retrieve sections, and generate accurate citations from any blog or CMS through read-only WebMCP tools.77 npmMIT