mcp-server-moegirl-wiki
Search and retrieve plain-text content from Moegirl Wiki.
Search entries by keyword with a configurable result limit (default 5), returning titles, URLs, snippets, and count.
Fetch a page by title and return its full plain-text content, URL, and page ID, automatically following redirects.
Truncate page content to a configurable
max_length(default 6250), with the default tunable viaMOEGIRL_MAX_LENGTH.
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., "@mcp-server-moegirl-wiki Search Moegirl Wiki for 初音ミク"
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.
mcp-server-moegirl-wiki
English | 简体中文
MCP server for 萌娘百科 (Moegirl Wiki). Two tools: search entries and fetch a page's intro.
Requires the MCP Python SDK 2.x (mcp>=2,<3); see Compatibility if you are still on 0.2.x.
Install
uvx mcp-server-moegirl-wiki # recommended
pipx run mcp-server-moegirl-wiki
pip install mcp-server-moegirl-wikiRelated MCP server: Internetsearch-mcp-server
Tools
search_moegirl(keyword: str, limit: int = 5)
Returns {"results": [{"title", "url", "snippet"}, ...], "count": int}.
get_page(title: str, max_length: int = 6250)
Returns {"title", "content", "url", "page_id"} — full plain-text rendering of the page (all sections, templates expanded, links resolved). Auto-follows redirects. content is truncated to max_length characters; default 6250 covers a typical character page in full, pass larger (e.g. 20000) for very long pages.
Environment variables
Variable | Default | Description |
|
| Default |
Configuration
Claude Desktop
{
"mcpServers": {
"moegirl-wiki": {
"command": "uvx",
"args": ["mcp-server-moegirl-wiki"]
}
}
}MaiBot (config/bot_config.toml)
MaiBot's default config already has the [mcp] block — just replace the servers line:
servers = [{name = "moegirl", enabled = true, transport = "stdio", command = "uvx", args = ["mcp-server-moegirl-wiki"], env = {MOEGIRL_MAX_LENGTH = "6250"}, url = "", headers = {}, http_timeout_seconds = 30.0, read_timeout_seconds = 300.0, authorization = {mode = "none", bearer_token = ""}}]Tweak MOEGIRL_MAX_LENGTH to taste (raise to 20000 for very long pages, lower to 1500 for quick lookups). If uvx is not on PATH, swap command/args for command = "pipx", args = ["run", "mcp-server-moegirl-wiki"].
Development
git clone https://github.com/XXXxx7258/mcp-server-moegirl-wiki
cd mcp-server-moegirl-wiki
uv sync --group dev
uv run pytest -m network
uv run ruff check .Compatibility
Server version | MCP Python SDK | Notes |
|
| SDK 2.0 renamed |
|
| Crashes at startup on SDK 2.x ( |
Limitations
get_pagereturns rendered plain text (templates expanded, links resolved). Raw wikitext (prop=revisions,action=parse,?action=raw,Special:Export) is blocked by Moegirl Wiki's site-wide ACL — empirically verified that bot-password login does not unlock it; onlysysop/staff groups can call these actions.Uses the
mzh.moegirl.org.cnmirror.Proxy variables are honoured via
httpx'strust_env. SomeNO_PROXYvalues are valid for curl but unparseable forhttpx(e.g. a bare::1next to[::1]); in that case the server logs a warning and issues direct requests instead of failing every tool call.
License
Available Tools
2 toolsget_pageA
获取萌娘百科条目的纯文本全文(所有章节、模板已展开、链接已解析、自动跟随重定向、按 max_length 截断)。
Inputs: title (required), max_length.
search_moegirlA
搜索萌娘百科条目。先用 generator=search 全文索引(命中时同时返回摘要片段),0 命中或异常时退回 opensearch 标题模糊匹配以保命中率。
Inputs: keyword (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: one searches for pages, the other retrieves the content of a specific page. There is no overlap or ambiguity.
Both tool names follow a consistent verb_noun pattern (get_page, search_moegirl), using snake_case. The naming is clear and predictable.
With only two tools, the server feels minimal for a wiki. While it covers basic search and retrieval, the scope is narrow; typically 4-8 tools would be more appropriate.
The tool surface has significant gaps for a wiki domain: missing operations like listing pages, retrieving sections, getting categories, or browsing history. Agents will likely fail to accomplish common wiki tasks.
Maintenance
Related MCP Connectors
MCP server for Chinese dictionary lookup: character definitions, pinyin, stroke order and word
MCP server for Chinese law lookup: statutes, regulations and articles by keyword or law name.
MCP server for China Railway 12306 ticket availability: schedules and seats by Chinese station name.
Related MCP Servers
- FlicenseDqualityDmaintenanceA MCP server that fetches and renders Baidu Baike (Chinese Wikipedia) discussion content, allowing users to access encyclopedia article discussions and generate readable analysis of the structured data.1-
- AlicenseBqualityDmaintenance一个用于联网搜索的MCP服务器,基于博查搜索API A MCP server for internet search, based on the Bocha Search API1MIT
- FlicenseNot gradedqualityDmaintenanceMCP server to search and read documentation pages from a WikiJS instance via its GraphQL API.-
- AlicenseNot gradedqualityBmaintenanceMCP server for searching and reading Wikipedia articles, including summaries, full text, targeted sections, nearby pages, and language editions.696 npm6Apache 2.0