Skip to content
Back to search

touhou-wiki

SkillWorks with Claude CodeGitHub

Query Touhou Wiki (en.touhouwiki.net) live over HTTP/2 for Touhou Project characters, locations, spell cards, music, games, and print works.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/remilya--touhou-mcp/badge.svg)](/listings/remilya--touhou-mcp)

HTML

<a href="/listings/remilya--touhou-mcp"><img src="/api/listings/remilya--touhou-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Antigravity CLI (Recommended)

Install directly from GitHub:

agy plugin install https://github.com/Remilya/Touhou-mcp

Or 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-mcp

2. Manual Global Plugin Install (Antigravity App / IDE)

Clone or copy this repository into your global Antigravity plugins directory:

- **macOS / Linux:** `~/.gemini/config/plugins/touhou-wiki` - **Windows:** `%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"]
    }
  }
}

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

plugin.json · Manifest · 29 lines
  1. {
  2. "$schema": "https://antigravity.google/schemas/v1/plugin.json",
  3. "name": "touhou-wiki",
  4. "displayName": "Touhou Wiki",
  5. "version": "1.0.0",
  6. "description": "Query Touhou Wiki (en.touhouwiki.net) live over HTTP/2 for Touhou Project characters, locations, spell cards, music, games, and print works.",
  7. "logo": "assets/logo.svg",
  8. "suggestedPrompts": [
  9. "Look up Reimu Hakurei's canonical abilities, personality, and official profiles on Touhou Wiki",
  10. "Search Touhou Wiki for Spell Card rules and summarize the key mechanics",
  11. "List canonical locations in Touhou Wiki Category:Locations and inspect Hakurei Shrine"
  12. ],
  13. "author": {
  14. "name": "Remilya",
  15. "url": "https://github.com/Remilya"
  16. },
  17. "homepage": "https://github.com/Remilya/Touhou-mcp",
  18. "repository": "https://github.com/Remilya/Touhou-mcp",
  19. "license": "MIT",
  20. "keywords": [
  21. "touhou",
  22. "touhou-wiki",
  23. "gensokyo",
  24. "wiki",
  25. "lore",
  26. "mediawiki",
  27. "mcp"
  28. ]
  29. }
README.md · README · 116 lines
  1. # Touhou Wiki Plugin (`touhou-wiki`)
  2. Zero-dependency **Antigravity Plugin**, **Model Context Protocol (MCP) server**, **Antigravity Skill**, and **CLI** for live HTTP/2 queries against [Touhou Wiki](https://en.touhouwiki.net).
  3. 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.
  4. ---
  5. ## Features
  6. - **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.
  7. - **1 MCP Resource** (`touhou-wiki://guide/categories`) exposing canonical Touhou Wiki categories and official game (`TH01`–`TH20`) / print-work abbreviations.
  8. - **Antigravity Skill** (`skills/touhou-wiki/SKILL.md`) guiding agents to inspect Table of Contents first, fetch targeted sections, verify canon vs. doujin categories, and cite `en.touhouwiki.net` URLs.
  9. - **Standalone CLI** (`scripts/touhou-wiki-cli.mjs`) for terminal scripts or non-MCP environments.
  10. ---
  11. ## Installation
  12. ### 1. Antigravity CLI (Recommended)
  13. Install directly from GitHub:
  14. ```bash
  15. agy plugin install https://github.com/Remilya/Touhou-mcp
  16. ```
  17. Or validate and install from a local clone:
  18. ```bash
  19. git clone https://github.com/Remilya/Touhou-mcp.git
  20. agy plugin validate --strict ./Touhou-mcp
  21. agy plugin install ./Touhou-mcp
  22. ```
  23. ### 2. Manual Global Plugin Install (Antigravity App / IDE)
  24. Clone or copy this repository into your global Antigravity plugins directory:
  25. - **macOS / Linux:** `~/.gemini/config/plugins/touhou-wiki`
  26. - **Windows:** `%USERPROFILE%\.gemini\config\plugins\touhou-wiki`
  27. Then open **Customizations** in Antigravity to verify `Touhou Wiki` appears with its bundled MCP server and `touhou-wiki` skill.
  28. ### 3. Standalone MCP Server Only (Claude Desktop / Cursor / Windsurf / Custom `mcp_config.json`)
  29. Point any MCP client at `scripts/touhou-wiki-mcp.mjs` using Node.js 18+:
  30. ```json
  31. {
  32. "mcpServers": {
  33. "touhou-wiki": {
  34. "command": "node",
  35. "args": ["/path/to/Touhou-mcp/scripts/touhou-wiki-mcp.mjs"]
  36. }
  37. }
  38. }
  39. ```
  40. ---
  41. ## Exposed MCP Tools
  42. | Tool Name | Purpose | Key Arguments |
  43. | :--- | :--- | :--- |
  44. | **`touhou_wiki_search`** | Combined title (`opensearch`) and full-text MediaWiki search (`ns=0`). | `query`, `limit`, `include_subpages` |
  45. | **`touhou_wiki_get_page`** | Fetch structured Infobox, kanji/romaji metadata, primary image URL, categories, TOC, and cleaned text. | `title`, `max_chars`, `include_raw_wikitext`, `resolve_image` |
  46. | **`touhou_wiki_get_sections`** | Retrieve article Table of Contents (section indices, levels, titles, anchors). | `title` |
  47. | **`touhou_wiki_get_section`** | Fetch a single section by numeric index (`"0"` for Lead) or heading name (`"Personality"`). | `title`, `section`, `max_chars`, `include_raw_wikitext` |
  48. | **`touhou_wiki_list_category`** | Browse pages or subcategories in a `Category:...` with `continue_token` pagination. | `category`, `type`, `limit`, `continue_token` |
  49. | **`touhou_wiki_list_subpages`** | List `<Title>/...` subpages (e.g., `Perfect Memento in Strict Sense`). | `title`, `limit` |
  50. | **`touhou_wiki_get_image_info`** | Resolve direct image URLs, dimensions, and MIME types for `File:...` names or an article's images. | `files`, `page`, `limit` |
  51. ### Exposed MCP Resource
  52. | URI | MIME Type | Contents |
  53. | :--- | :--- | :--- |
  54. | `touhou-wiki://guide/categories` | `application/json` | Canonical Touhou Wiki categories plus `TH01`–`TH20` and print-work abbreviations. |
  55. ---
  56. ## Standalone CLI Usage
  57. ```bash
  58. node scripts/touhou-wiki-cli.mjs --help
  59. node scripts/touhou-wiki-cli.mjs search "Hakurei Shrine" --limit 5
  60. node scripts/touhou-wiki-cli.mjs page "Reimu Hakurei" --max-chars 3000
  61. node scripts/touhou-wiki-cli.mjs sections "Embodiment of Scarlet Devil"
  62. node scripts/touhou-wiki-cli.mjs section "Reimu Hakurei" "Personality"
  63. node scripts/touhou-wiki-cli.mjs category "Locations" --type articles --limit 25
  64. node scripts/touhou-wiki-cli.mjs subpages "Perfect Memento in Strict Sense" --limit 15
  65. node scripts/touhou-wiki-cli.mjs images --files "File:Th20Reimu.png"
  66. ```
  67. ---
  68. ## Local Verification & Testing
  69. Run the offline unit tests (wikitext unwrapping, infobox extraction, tool schemas, resource checks):
  70. ```bash
  71. npm test
  72. ```
  73. Run the full live HTTP/2 integration suite against `https://en.touhouwiki.net`:
  74. ```bash
  75. npm run test:live
  76. ```
  77. ---
  78. ## License & Attribution
  79. - Plugin code, MCP server, CLI, and skill documentation are licensed under the [MIT License](./LICENSE).
  80. - Article text and media retrieved at runtime originate from [Touhou Wiki (`en.touhouwiki.net`)](https://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.

Version history

  • v1.0.011/22/2026

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.