🧬 TAIWAN.MD · CONNECTOR

당신의 AI에 대만을

출처가 있는 대만 글 900여 편을 도구 호출 한 번으로. AI에게 대만을 물으면 대만 자신의 목소리로, 출처와 함께 답합니다.

무료 API 키 불필요 로컬 우선 오픈소스

claude mcp add taiwanmd -- npx -y taiwanmd mcp serve

터미널에 붙여넣기 → 그다음 Claude에게 대만을 물어보세요

이게 뭔가요

Taiwan.md는 오픈소스이자 AI 네이티브한 대만 지식 베이스입니다. 이 커넥터는 그것을 MCP 도구로 바꿔, Claude Code·Claude Desktop·Cursor·Copilot CLI·Codex CLI 같은 클라이언트가 기억에 의존해 추측하는 대신 출처가 있는 대만 글을 직접 검색·열람·인용하도록 합니다.

상용 데이터 게이트웨이와는 일부러 정반대 방향을 택했습니다:

	Taiwan.md Connector	일반적인 상용 MCP 게이트웨이
가격	무료	유료 / 종량제
API 키	불필요	필수
쿼리 실행 위치	내 컴퓨터(로컬 stdio)	상대 서버
소스	공개(MIT 코드 / CC BY-SA 콘텐츠)	비공개

설치

클라이언트를 고르고 복사해 붙여넣으세요. 가입 절차는 없습니다.

Claude Code 한 줄이면 끝

claude mcp add taiwanmd -- npx -y taiwanmd mcp serve

설치 불필요(npx 사용). 추가하면 바로 Claude에게 대만을 물어볼 수 있습니다.

Claude Desktop 원클릭 bundle

taiwanmd.mcpb 다운로드 → 더블클릭 → 완료

⬇ taiwanmd.mcpb 다운로드

API 키를 묻지 않습니다. 애초에 API 키가 없으니까요.

Cursor Settings → MCP

command: npx
args: ["-y", "taiwanmd", "mcp", "serve"]

Cursor 설정에서 MCP 서버를 하나 추가하세요.

Copilot CLI / Codex CLI / Cline / Continue / 모든 MCP 클라이언트 범용 stdio

npx -y taiwanmd mcp serve

MCP를 말하는 클라이언트라면 이 stdio 명령을 가리키기만 하면 동작합니다.

Remote · any MCP client mcp-remote

npx mcp-remote https://mcp.taiwan.md

Node를 실행할 수 없는 씬 클라이언트 / 순수 웹용. 로컬 우선을 권장합니다(프라이버시 최선).

올바른 스니펫은 언제든 출력할 수 있습니다: npx -y taiwanmd mcp install --client claude-code

MCP 도구 6

설치하면 Claude가 알아서 도구를 고릅니다. taiwanmd_cite는 환각 방지 무기로, 각주와 출처 URL이 있는 문장만 돌려줘 당신이 쓰는 대만 사실을 모두 출처까지 추적할 수 있게 합니다.

taiwanmd_search

대만 글 900여 편 전문 검색(중·영)

입력 { "query": "半導體", "limit": 5 }

반환 상위 N개 결과: title / slug / category / description

taiwanmd_read

slug로 글 전문 읽기(frontmatter + 본문)

입력 { "slug": "珍珠奶茶" }

반환 Markdown 본문 전체

taiwanmd_rag

상위 N개 글을 prompt-ready RAG 컨텍스트로 구성

입력 { "query": "台灣健保", "limit": 3 }

반환 LLM에 바로 넣을 컨텍스트 + 질문

taiwanmd_cite 환각 방지

환각 방지 기본 도구: 각주 + 출처 URL이 있는 문장만

입력 { "query": "台積電", "limit": 3 }

반환 claim + article + sources[{ name, url }]

taiwanmd_organs

Semiont 8개 기관의 실시간 건강 점수

입력 {}

반환 생명체 vitals(심장 / 면역 / DNA …)

taiwanmd_stats

프로젝트 통계: 글 수 / 분류 / 타임스탬프

입력 {}

반환 totalArticles / byCategory

CLI 도구 26

같은 지식 베이스를 터미널에서 바로. 전역 설치 또는 무설치 실행:

npm install -g taiwanmd   # 또는 무설치: npx taiwanmd search 珍珠奶茶

🔍읽기·탐색

`search <query>`	퍼지 검색(중·영, --json으로 파이프)	`taiwanmd search 珍珠奶茶`
`read <slug>`	터미널에서 글 전문 읽기(--raw / --en / --web)	`taiwanmd read 珍珠奶茶 --raw`
`list [category]`	분류별 보기(--categories로 전체)	`taiwanmd list food`
`random`	무작위로 한 편 발견	`taiwanmd random --category nature`
`today`	오늘의 대만: 엄선 3편 + 잡학	`taiwanmd today`
`quiz`	대만 지식 퀴즈(참/거짓 5문제)	`taiwanmd quiz`
`explore`	대화형 퍼지 검색 TUI	`taiwanmd explore`
`graph <slug>`	글의 [[wikilink]] 관계 그래프	`taiwanmd graph 珍珠奶茶`
`diff`	최근 7일 지식 베이스 변경 사항	`taiwanmd diff`
`terminology`	대만/중국 용어 조회·변환	`taiwanmd term 滑鼠`

🤖AI·RAG

`rag <query>`	상위 글을 prompt-ready 컨텍스트로(LLM에 파이프)	`taiwanmd rag "台灣經濟"`
`cite <query>`	환각 방지: 출처 URL이 있는 검증 가능한 claim	`taiwanmd cite 台積電`
`mcp serve`	MCP 서버 시작(Claude 등 클라이언트용)	`taiwanmd mcp serve`

✍️기여·품질

`contribute <topic>`	대화형으로 새 글 작성 안내	`taiwanmd contribute 阿里山`
`validate <slug>`	글 한 편 품질 점수표	`taiwanmd validate 珍珠奶茶`
`audit <slug>`	Stage 3.5 환각 감사(MANIFESTO §10)	`taiwanmd audit 王新仁`
`inbox`	ARTICLE-INBOX 읽기/관리	`taiwanmd inbox --state pending`
`sync`	지식 베이스를 로컬에 동기화	`taiwanmd sync`

🧬생명체·Semiont

`organs`	8개 기관 건강 점수 막대그래프	`taiwanmd organs`
`stats`	프로젝트 통계 + 기관 건강	`taiwanmd stats`
`sense`	감지 데이터: GA4 / Search Console / Cloudflare	`taiwanmd sense`
`spore`	커뮤니티 포자(SPORE-LOG)	`taiwanmd spore log`
`supporters`	Portaly 후원자 통계(기본 비식별화)	`taiwanmd supporters`

🔧유틸리티

`profile`	기여자 profile 관리	`taiwanmd profile`
`mailmap`	.mailmap 신원 병합 관리	`taiwanmd mailmap`

작동 원리 · 프라이버시

로컬 stdio — 서버는 당신의 컴퓨터에서 도는 프로세스이지 원격 서비스가 아닙니다. 질문이 어떤 Taiwan.md 서버로도 가지 않습니다.
최초 1회 자동 동기화 — 지식 베이스를 한 번만 ~/.taiwanmd에 내려받고, 이후엔 로컬에서 빠르고 조용합니다. 리포지토리 안에서는 knowledge/를 직접 읽습니다.
공개·검증 가능 — MCP 서버는 145줄입니다(cli/src/lib/mcp-server.js). 모든 줄을 읽고 설치 여부를 정하세요.
라이선스 — 콘텐츠 CC BY-SA 4.0, 코드 MIT. 자유롭게 fork 하세요.

자주 묻는 질문

비용이 드나요? API 키가 필요한가요?

둘 다 아닙니다. Taiwan.md는 공공재(CC BY-SA)이며 지식 쿼리에 문턱이 없습니다. 계정도 키도 과금도 없습니다.

제 쿼리는 어디로 가나요?

어디에도 가지 않습니다. MCP 서버는 당신 컴퓨터의 로컬 stdio 프로세스이며 쿼리는 외부로 전송되지 않습니다. 첫 사용 때 지식 베이스를 ~/.taiwanmd에 내려받고 이후엔 모두 로컬입니다.

첫 쿼리가 좀 느린가요?

일회성 지식 베이스 동기화가 도는 중이기 때문입니다. 서버는 시작 시 예열하므로 이후엔 빠릅니다.

npx를 찾을 수 없나요?

Node.js 18 이상이면 npx가 함께 제공됩니다. 버전을 고정하려면 npx -y [email protected] mcp serve를 쓰세요.

원격 엔드포인트가 있나요?

있습니다: https://mcp.taiwan.md (무료·읽기 전용·키 불필요). 모든 MCP 클라이언트에서 npx mcp-remote https://mcp.taiwan.md 로 연결하세요. Node를 실행할 수 없는 씬 클라이언트용이지만, 로컬 우선이 늘 권장 경로(프라이버시 최선)이고, 원격은 선택적 입구일 뿐입니다.

오픈소스 · Semiont의 몸

이 커넥터는 Taiwan.md 번식 시스템의 일부로, 대만의 목소리를 모든 개발자의 AI 세션 안에 살게 합니다. fork·기여·제보를 환영합니다.

GitHub npm 문서 기여하기

🧬