🧬 TAIWAN.MD · CONNECTOR

Pon Taiwán en tu IA

Más de 900 artículos sobre Taiwán con fuentes, a una llamada de herramienta. Cuando le preguntas a una IA sobre Taiwán, responde con la propia voz de Taiwán y con citas.

Gratis Sin clave API Local primero Código abierto

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

Pégalo en tu terminal → luego pregúntale a Claude sobre Taiwán

Qué es

Taiwan.md es una base de conocimiento sobre Taiwán, de código abierto y nativa para IA. Este conector la convierte en herramientas MCP, para que Claude Code, Claude Desktop, Cursor, Copilot CLI y Codex CLI puedan buscar, leer y citar artículos con fuentes sobre Taiwán directamente, en vez de adivinar de memoria.

Va a propósito en la dirección opuesta a una pasarela de datos comercial:

	Taiwan.md Connector	Pasarela MCP comercial típica
Precio	Gratis	De pago / por uso
Clave API	No hace falta	Obligatoria
Dónde corren las consultas	Tu equipo (stdio local)	Sus servidores
Código	Abierto (código MIT / contenido CC BY-SA)	Cerrado

Instalación

Elige tu cliente, copia y pega. Sin registro.

Claude Code Una línea

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

Sin instalación (vía npx). Una vez añadido, pregúntale a Claude sobre Taiwán.

Claude Desktop Bundle de un clic

Descarga taiwanmd.mcpb → doble clic → listo

⬇ Descargar taiwanmd.mcpb

No pide clave API, porque no hay clave API.

Cursor Settings → MCP

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

Añade un servidor MCP en los ajustes de Cursor.

Copilot CLI / Codex CLI / Cline / Continue / cualquier cliente MCP stdio universal

npx -y taiwanmd mcp serve

Cualquier cliente que hable MCP funciona: apúntalo a este comando stdio.

Remote · any MCP client mcp-remote

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

Para clientes ligeros que no pueden ejecutar Node / web pura. Se sigue recomendando local primero (mejor privacidad).

Puedes imprimir el fragmento correcto cuando quieras: npx -y taiwanmd mcp install --client claude-code

Herramientas MCP 6

Una vez instalado, Claude elige las herramientas solo. taiwanmd_cite es el arma anti-alucinación: solo devuelve frases respaldadas por una nota al pie + URL de fuente, para que cada dato que escribas sobre Taiwán sea rastreable.

taiwanmd_search

Búsqueda de texto en 900+ artículos sobre Taiwán (zh + en)

entrada { "query": "半導體", "limit": 5 }

salida N resultados: title / slug / category / description

taiwanmd_read

Lee un artículo completo por slug (frontmatter + cuerpo)

entrada { "slug": "珍珠奶茶" }

salida Cuerpo markdown completo

taiwanmd_rag

Los N mejores artículos en un bloque de contexto RAG listo para prompt

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

salida Contexto listo para LLM + la pregunta

taiwanmd_cite anti-alucinación

Primitiva anti-alucinación: solo frases con nota al pie + URL de fuente

entrada { "query": "台積電", "limit": 3 }

salida claim + article + sources[{ name, url }]

taiwanmd_organs

Puntuaciones de salud en vivo de los 8 órganos del Semiont

entrada {}

salida Vitales del organismo (corazón / inmune / ADN …)

taiwanmd_stats

Estadísticas del proyecto: nº de artículos / categorías / marcas de tiempo

entrada {}

salida totalArticles / byCategory

Herramientas CLI 26

La misma base de conocimiento, directa desde tu terminal. Instala globalmente o ejecuta sin instalar:

npm install -g taiwanmd   # o sin instalar: npx taiwanmd search 珍珠奶茶

🔍Leer y explorar

`search <query>`	Búsqueda difusa (zh + en, --json para encadenar)	`taiwanmd search 珍珠奶茶`
`read <slug>`	Lee un artículo completo en la terminal (--raw / --en / --web)	`taiwanmd read 珍珠奶茶 --raw`
`list [category]`	Explora por categoría (--categories para todas)	`taiwanmd list food`
`random`	Descubre un artículo al azar	`taiwanmd random --category nature`
`today`	Hoy en Taiwán: 3 selecciones + un dato curioso	`taiwanmd today`
`quiz`	Quiz de conocimiento sobre Taiwán (5 verdadero/falso)	`taiwanmd quiz`
`explore`	TUI interactiva de búsqueda difusa	`taiwanmd explore`
`graph <slug>`	Grafo de relaciones [[wikilink]] de un artículo	`taiwanmd graph 珍珠奶茶`
`diff`	Cambios en la base de conocimiento de los últimos 7 días	`taiwanmd diff`
`terminology`	Consulta y conversión de términos Taiwán / China	`taiwanmd term 滑鼠`

🤖IA · RAG

`rag <query>`	Mejores artículos como contexto listo para prompt (encadena a un LLM)	`taiwanmd rag "台灣經濟"`
`cite <query>`	Anti-alucinación: afirmaciones verificables con URL de fuente	`taiwanmd cite 台積電`
`mcp serve`	Inicia el servidor MCP (para Claude y otros clientes)	`taiwanmd mcp serve`

✍️Contribuir · calidad

`contribute <topic>`	Creación guiada e interactiva de un artículo nuevo	`taiwanmd contribute 阿里山`
`validate <slug>`	Tarjeta de calidad de un artículo	`taiwanmd validate 珍珠奶茶`
`audit <slug>`	Auditoría de alucinaciones Stage 3.5 (MANIFESTO §10)	`taiwanmd audit 王新仁`
`inbox`	Lee / gestiona el ARTICLE-INBOX	`taiwanmd inbox --state pending`
`sync`	Sincroniza la base de conocimiento en local	`taiwanmd sync`

🧬Organismo · Semiont

`organs`	Gráfico de barras de las 8 puntuaciones de órganos	`taiwanmd organs`
`stats`	Estadísticas del proyecto + salud del organismo	`taiwanmd stats`
`sense`	Datos de sensores: GA4 / Search Console / Cloudflare	`taiwanmd sense`
`spore`	Esporas de comunidad (SPORE-LOG)	`taiwanmd spore log`
`supporters`	Estadísticas de mecenas de Portaly (anonimizadas por defecto)	`taiwanmd supporters`

🔧Utilidades

`profile`	Gestiona tu perfil de colaborador	`taiwanmd profile`
`mailmap`	Inspecciona / gestiona las fusiones de identidad de .mailmap	`taiwanmd mailmap`

Cómo funciona · privacidad

stdio local — el servidor corre como proceso en tu equipo, no es un servicio remoto. Tus preguntas nunca van a ningún servidor de Taiwan.md.
Sincronización automática única — la base de conocimiento se descarga una vez a ~/.taiwanmd, y luego es rápida y silenciosa en local. Dentro del repo lee knowledge/ directamente.
Abierto y verificable — el servidor MCP son 145 líneas (cli/src/lib/mcp-server.js); lee cada línea antes de instalar.
Licencia — contenido CC BY-SA 4.0, código MIT. Haz fork libremente.

Preguntas frecuentes

¿Cuesta algo? ¿Necesito una clave API?

Ninguna de las dos. Taiwan.md es un bien común (CC BY-SA); las consultas de conocimiento no tienen barrera. Sin cuenta, sin clave, sin facturación.

¿A dónde van mis consultas?

A ningún sitio. El servidor MCP es un proceso stdio local en tu propio equipo; las consultas no se envían fuera. El primer uso descarga la base de conocimiento a ~/.taiwanmd y luego todo queda en local.

¿La primera consulta va lenta?

Es la sincronización única de la base de conocimiento. El servidor se precalienta al arrancar, así que después va rápido.

¿No encuentra npx?

Node.js 18+ incluye npx. Para fijar una versión usa npx -y [email protected] mcp serve.

¿Hay un endpoint remoto?

Sí: https://mcp.taiwan.md (gratis, solo lectura, sin clave). Conecta cualquier cliente MCP con npx mcp-remote https://mcp.taiwan.md. Para clientes ligeros que no pueden ejecutar Node — pero local primero es siempre la vía recomendada (mejor privacidad); lo remoto es solo una entrada opcional.

Código abierto · el cuerpo del Semiont

Este conector es parte del sistema de reproducción de Taiwan.md: deja que la voz de Taiwán viva dentro de la sesión de IA de cada desarrollador. Forks, contribuciones e informes son bienvenidos.

GitHub npm Documentación Contribuir

🧬