🧬 TAIWAN.MD · CONNECTOR

Mets Taïwan dans ton IA

Plus de 900 articles sourcés sur Taïwan, à un appel d’outil. Quand tu interroges une IA sur Taïwan, elle répond avec la voix de Taïwan elle-même — sources à l’appui.

Gratuit Sans clé API Local d’abord Open source

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

Colle-le dans ton terminal → puis interroge Claude sur Taïwan

Qu’est-ce que c’est

Taiwan.md est une base de connaissances sur Taïwan, open source et pensée pour l’IA. Ce connecteur la transforme en outils MCP, pour que Claude Code, Claude Desktop, Cursor, Copilot CLI et Codex CLI puissent chercher, lire et citer directement des articles sourcés sur Taïwan, au lieu de deviner de mémoire.

Il prend volontairement le contre-pied d’une passerelle de données commerciale :

	Taiwan.md Connector	Passerelle MCP commerciale typique
Prix	Gratuit	Payant / à l’usage
Clé API	Inutile	Obligatoire
Où tournent les requêtes	Ta machine (stdio local)	Leurs serveurs
Source	Ouverte (code MIT / contenu CC BY-SA)	Fermée

Installation

Choisis ton client, copie-colle. Aucune inscription.

Claude Code Une ligne

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

Sans installation (via npx). Une fois ajouté, interroge Claude sur Taïwan.

Claude Desktop Bundle en un clic

Télécharge taiwanmd.mcpb → double-clic → terminé

⬇ Télécharger taiwanmd.mcpb

Aucune demande de clé API — parce qu’il n’y a pas de clé API.

Cursor Settings → MCP

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

Ajoute un serveur MCP dans les réglages de Cursor.

Copilot CLI / Codex CLI / Cline / Continue / n’importe quel client MCP stdio universel

npx -y taiwanmd mcp serve

Tout client qui parle MCP fonctionne : pointe-le vers cette commande stdio.

Remote · any MCP client mcp-remote

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

Pour les clients légers qui ne peuvent pas exécuter Node / web pur. Le local d’abord reste recommandé (meilleure confidentialité).

Tu peux afficher le bon extrait à tout moment : npx -y taiwanmd mcp install --client claude-code

Outils MCP 6

Une fois installé, Claude choisit les outils lui-même. taiwanmd_cite est l’arme anti-hallucination : il ne renvoie que des phrases adossées à une note de bas de page + une URL de source, pour que chaque fait que tu écris sur Taïwan soit traçable.

taiwanmd_search

Recherche plein texte dans 900+ articles sur Taïwan (zh + en)

entrée { "query": "半導體", "limit": 5 }

sortie N résultats : title / slug / category / description

taiwanmd_read

Lit un article complet par slug (frontmatter + corps)

entrée { "slug": "珍珠奶茶" }

sortie Corps markdown complet

taiwanmd_rag

Les N meilleurs articles assemblés en bloc de contexte RAG prêt pour le prompt

entrée { "query": "台灣健保", "limit": 3 }

sortie Contexte prêt pour le LLM + la question

taiwanmd_cite anti-hallucination

Primitive anti-hallucination : seulement les phrases avec note + URL de source

entrée { "query": "台積電", "limit": 3 }

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

taiwanmd_organs

Scores de santé en direct des 8 organes du Semiont

entrée {}

sortie Constantes de l’organisme (cœur / immunité / ADN …)

taiwanmd_stats

Statistiques du projet : nombre d’articles / catégories / horodatages

entrée {}

sortie totalArticles / byCategory

Outils CLI 26

La même base de connaissances, directement dans ton terminal. Installe en global ou exécute sans installer :

npm install -g taiwanmd   # ou sans installation : npx taiwanmd search 珍珠奶茶

🔍Lire et explorer

`search <query>`	Recherche floue (zh + en, --json pour chaîner)	`taiwanmd search 珍珠奶茶`
`read <slug>`	Lit un article complet dans le terminal (--raw / --en / --web)	`taiwanmd read 珍珠奶茶 --raw`
`list [category]`	Parcourt par catégorie (--categories pour toutes)	`taiwanmd list food`
`random`	Découvre un article au hasard	`taiwanmd random --category nature`
`today`	Aujourd’hui à Taïwan : 3 sélections + une anecdote	`taiwanmd today`
`quiz`	Quiz de connaissances sur Taïwan (5 vrai/faux)	`taiwanmd quiz`
`explore`	TUI interactive de recherche floue	`taiwanmd explore`
`graph <slug>`	Graphe de relations [[wikilink]] d’un article	`taiwanmd graph 珍珠奶茶`
`diff`	Changements de la base sur les 7 derniers jours	`taiwanmd diff`
`terminology`	Recherche et conversion de termes Taïwan / Chine	`taiwanmd term 滑鼠`

🤖IA · RAG

`rag <query>`	Meilleurs articles en contexte prêt pour le prompt (à chaîner vers un LLM)	`taiwanmd rag "台灣經濟"`
`cite <query>`	Anti-hallucination : affirmations vérifiables avec URL de source	`taiwanmd cite 台積電`
`mcp serve`	Démarre le serveur MCP (pour Claude et d’autres clients)	`taiwanmd mcp serve`

✍️Contribuer · qualité

`contribute <topic>`	Création guidée et interactive d’un nouvel article	`taiwanmd contribute 阿里山`
`validate <slug>`	Fiche de qualité d’un article	`taiwanmd validate 珍珠奶茶`
`audit <slug>`	Audit d’hallucinations Stage 3.5 (MANIFESTO §10)	`taiwanmd audit 王新仁`
`inbox`	Lit / gère l’ARTICLE-INBOX	`taiwanmd inbox --state pending`
`sync`	Synchronise la base de connaissances en local	`taiwanmd sync`

🧬Organisme · Semiont

`organs`	Diagramme en barres des 8 scores d’organes	`taiwanmd organs`
`stats`	Statistiques du projet + santé de l’organisme	`taiwanmd stats`
`sense`	Données de capteurs : GA4 / Search Console / Cloudflare	`taiwanmd sense`
`spore`	Spores communautaires (SPORE-LOG)	`taiwanmd spore log`
`supporters`	Statistiques des soutiens Portaly (anonymisées par défaut)	`taiwanmd supporters`

🔧Utilitaires

`profile`	Gère ton profil de contributeur	`taiwanmd profile`
`mailmap`	Inspecte / gère les fusions d’identité .mailmap	`taiwanmd mailmap`

Fonctionnement · confidentialité

stdio local — le serveur tourne comme un processus sur ta machine, pas un service distant. Tes questions ne vont vers aucun serveur Taiwan.md.
Synchro automatique unique — la base se télécharge une fois vers ~/.taiwanmd, puis c’est rapide et discret en local. Dans le dépôt, elle lit knowledge/ directement.
Ouvert et vérifiable — le serveur MCP fait 145 lignes (cli/src/lib/mcp-server.js) ; lis chaque ligne avant d’installer.
Licence — contenu CC BY-SA 4.0, code MIT. Fork librement.

FAQ

Est-ce payant ? Faut-il une clé API ?

Ni l’un ni l’autre. Taiwan.md est un bien commun (CC BY-SA) ; les requêtes de connaissances n’ont pas de barrière. Pas de compte, pas de clé, pas de facturation.

Où vont mes requêtes ?

Nulle part. Le serveur MCP est un processus stdio local sur ta propre machine ; les requêtes ne sortent pas. La première utilisation télécharge la base vers ~/.taiwanmd, puis tout reste en local.

La première requête semble lente ?

C’est la synchro unique de la base qui tourne. Le serveur se préchauffe au démarrage, donc c’est rapide ensuite.

npx introuvable ?

Node.js 18+ fournit npx. Pour figer une version, utilise npx -y [email protected] mcp serve.

Y a-t-il un point d’accès distant ?

Oui : https://mcp.taiwan.md (gratuit, lecture seule, sans clé). Connecte n’importe quel client MCP avec npx mcp-remote https://mcp.taiwan.md. Pour les clients légers qui ne peuvent pas exécuter Node — mais le local d’abord reste la voie recommandée (meilleur pour la vie privée) ; le distant n’est qu’une entrée optionnelle.

Open source · le corps du Semiont

Ce connecteur fait partie du système de reproduction de Taiwan.md — il fait vivre la voix de Taïwan dans la session IA de chaque développeur. Forks, contributions et signalements bienvenus.

GitHub npm Documentation Contribuer

🧬