touhou-wiki
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., "@touhou-wiki show me the table of contents for Embodiment of Scarlet Devil"
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.
Touhou Wiki Plugin (touhou-wiki)
Zero-dependency Antigravity Plugin, Model Context Protocol (MCP) server, Antigravity Skill, and CLI for live HTTP/2 queries against Touhou Wiki.
Built on native Node.js (node:http2, node >= 18) with zero npm dependencies, balanced-brace MediaWiki Infobox extraction, Touhou Wiki template unwrapping ({{ruby-ja}}, {{lang}}, {{H:title}}, {{nihongo}}), and TTL caching.
Features
7 Live MCP Tools (
touhou_wiki_*) covering full-text & title search, structured Infobox + article fetching, TOC inspection, section-level extraction, category browsing, subpage discovery, and image URL/dimension resolution.1 MCP Resource (
touhou-wiki://guide/categories) exposing canonical Touhou Wiki categories and official game (TH01–TH20) / print-work abbreviations.Antigravity Skill (
skills/touhou-wiki/SKILL.md) guiding agents to inspect Table of Contents first, fetch targeted sections, verify canon vs. doujin categories, and citeen.touhouwiki.netURLs.Standalone CLI (
scripts/touhou-wiki-cli.mjs) for terminal scripts or non-MCP environments.
Related MCP server: MediaWiki MCP Server
Installation
1. Antigravity CLI (Recommended)
Install directly from GitHub:
agy plugin install https://github.com/Remilya/Touhou-mcpOr validate and install from a local clone:
git clone https://github.com/Remilya/Touhou-mcp.git
agy plugin validate --strict ./Touhou-mcp
agy plugin install ./Touhou-mcp2. Manual Global Plugin Install (Antigravity App / IDE)
Clone or copy this repository into your global Antigravity plugins directory:
macOS / Linux:
~/.gemini/config/plugins/touhou-wikiWindows:
%USERPROFILE%\.gemini\config\plugins\touhou-wiki
Then open Customizations in Antigravity to verify Touhou Wiki appears with its bundled MCP server and touhou-wiki skill.
3. Standalone MCP Server Only (Claude Desktop / Cursor / Windsurf / Custom mcp_config.json)
Point any MCP client at scripts/touhou-wiki-mcp.mjs using Node.js 18+:
{
"mcpServers": {
"touhou-wiki": {
"command": "node",
"args": ["/path/to/Touhou-mcp/scripts/touhou-wiki-mcp.mjs"]
}
}
}Exposed MCP Tools
Tool Name | Purpose | Key Arguments |
| Combined title ( |
|
| Fetch structured Infobox, kanji/romaji metadata, primary image URL, categories, TOC, and cleaned text. |
|
| Retrieve article Table of Contents (section indices, levels, titles, anchors). |
|
| Fetch a single section by numeric index ( |
|
| Browse pages or subcategories in a |
|
| List |
|
| Resolve direct image URLs, dimensions, and MIME types for |
|
Exposed MCP Resource
URI | MIME Type | Contents |
|
| Canonical Touhou Wiki categories plus |
Standalone CLI Usage
node scripts/touhou-wiki-cli.mjs --help
node scripts/touhou-wiki-cli.mjs search "Hakurei Shrine" --limit 5
node scripts/touhou-wiki-cli.mjs page "Reimu Hakurei" --max-chars 3000
node scripts/touhou-wiki-cli.mjs sections "Embodiment of Scarlet Devil"
node scripts/touhou-wiki-cli.mjs section "Reimu Hakurei" "Personality"
node scripts/touhou-wiki-cli.mjs category "Locations" --type articles --limit 25
node scripts/touhou-wiki-cli.mjs subpages "Perfect Memento in Strict Sense" --limit 15
node scripts/touhou-wiki-cli.mjs images --files "File:Th20Reimu.png"Local Verification & Testing
Run the offline unit tests (wikitext unwrapping, infobox extraction, tool schemas, resource checks):
npm testRun the full live HTTP/2 integration suite against https://en.touhouwiki.net:
npm run test:liveLicense & Attribution
Plugin code, MCP server, CLI, and skill documentation are licensed under the MIT License.
Article text and media retrieved at runtime originate from Touhou Wiki (
en.touhouwiki.net) and remain subject to its respective content licenses (including CC BY-SA where applicable). Touhou Project is created by ZUN / Team Shanghai Alice.
Available Tools
7 toolstouhou_wiki_get_image_infoA
Resolve direct image URLs, MIME types, and pixel dimensions for specific File:... names or all images embedded in a Touhou Wiki article.
Inputs: page, files, limit.
touhou_wiki_get_pageA
Fetch an article from en.touhouwiki.net with structured Infobox fields, Japanese kanji/romaji metadata, primary image URL, categories, section TOC, and cleaned article text.
Inputs: title (required), max_chars, resolve_image, include_raw_wikitext.
touhou_wiki_get_sectionA
Fetch a single section of a Touhou Wiki article by numeric section index (e.g. "0" for Lead/Infobox, "1", "2") or by section heading name (e.g. "Personality", "Abilities").
Inputs: title (required), section (required), max_chars, include_raw_wikitext.
touhou_wiki_get_sectionsA
Retrieve the Table of Contents (section index numbers, hierarchy levels, titles, and anchors) for a Touhou Wiki article without loading its full body.
Inputs: title (required).
touhou_wiki_list_categoryB
List pages or subcategories in a Touhou Wiki Category (e.g. "Category:Characters", "Category:Locations", "Category:Official Games"), with pagination support.
Inputs: category (required), type, limit, continue_token.
touhou_wiki_list_subpagesA
List subpages under a Touhou Wiki article prefix (e.g. "Perfect Memento in Strict Sense", "Embodiment of Scarlet Devil", "Forbidden Scrollery").
Inputs: title (required), limit.
touhou_wiki_searchA
Search en.touhouwiki.net across article titles (opensearch) and full article text (MediaWiki search). Returns ranked hits with URLs and clean text snippets.
Inputs: query (required), limit, include_subpages.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a distinct scope: search vs. full-page fetch vs. TOC-only vs. single-section vs. category listing vs. subpage listing vs. image metadata. The only mild overlap is between get_page (which includes the TOC and full text) and get_sections/get_section, but the descriptions make the cost/granularity tradeoff explicit enough that an agent can choose correctly.
All seven tools use the same touhou_wiki_ prefix followed by a consistent verb_noun pattern (search, get_page, get_sections, get_section, list_category, list_subpages, get_image_info) in snake_case. The singular/plural get_section vs get_sections pair is a deliberate and readable distinction rather than an inconsistency.
Seven tools is a well-scoped surface for a wiki server: retrieval, navigation, and media resolution each get focused, non-redundant tools. No tool feels like filler and none of the obvious access patterns is split into unnecessary variants.
The surface covers search, page retrieval, section navigation, category browsing, subpage enumeration, and image resolution — the core read-only workflows for a MediaWiki domain. Minor gaps remain for link graph operations (what-links-here, external links) and site-wide listings like recent changes, which agents would have to work around.
Maintenance
Related MCP Connectors
Search and read Wikipedia articles and sections, list cited references, nearby pages, and languages.
Live Wikipedia edit feed, page summaries, trending pages, and Wikidata search.
Search and fetch Wikidata entities, execute SPARQL queries, and resolve external identifiers.
Connect to your MediaWiki using simple credentials and manage content without OAuth. Search, read,…
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables searching and retrieving Wikipedia content across multiple languages, including article summaries, sections, coordinates, and related topics.-
- AlicenseNot gradedqualityAmaintenanceEnables LLM clients to search, read, create, edit, and manage pages, files, categories, and revisions on any wiki running the MediaWiki software, with optional OAuth-authenticated write access. Also exposes extension-specific capabilities such as Wikibase entities and SPARQL queries, Semantic MediaWiki and Cargo queries, and NeoWiki knowledge-graph subjects.8 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables LLM clients to read, search, create, edit, manage, and upload content across any MediaWiki wiki, including extension-backed querying and OAuth-authenticated writes.8 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables LLM clients to read, search, create, edit, move, protect, and delete pages, upload files, and query wiki data across any number of configured wikis. It supports per-wiki defaults, OAuth authentication, and extension packs for Semantic MediaWiki, Wikibase, Cargo, Bucket, and NeoWiki.8 npmMIT