内容
<!-- mcp-name: io.github.xfloukiex-lab/road-poneglyph -->
# 🗿 路标碑文
<img src="icon.png" width="120" align="right" alt="路标碑文 icon">
一款MCP服务器，审查计划中**缺失**的部分 — 您从未写下的假设、风险和空白。
一款 [模型上下文协议](https://modelcontextprotocol.io) (MCP) 服务器 — 一种专注的工具，您将其插入与MCP兼容的客户端（Claude Desktop、Claude Code、Cursor等）。
## 功能
语言模型擅长响应眼前的内容，但不擅长注意到**没有**的内容。要求它批评计划时，它往往会根据页面上的文字做出反应，而不是根据背后的未明假设。
路标碑文对计划进行结构化的**预先死亡**分析，并仅报告负面空间 — 假设未经证明的内容、技术上被忽略的内容以及在交付过程中跳过的内容。
## 用法
将您的助手指向计划，并要求它 *读取碑文*。工具返回一个包含三个部分的重点分析：
- **空白世纪** — 计划依赖的未明假设
- **隐藏礁石** — 省略的技术和架构风险
- **危险之海** — 运营和执行盲点
**工具参考：** `read_poneglyph(current_plan: str, project_type: str = "软件")`
## 工作原理
**无需API密钥，无需成本，机器上没有任何内容离开。** 服务器本身不调用语言模型 — 它返回一个精心设计的分析提示，由您已经在使用的模型执行。零凭证，零网络调用。
## 安装
需要Python 3.10或更新版本。
```bash
pip install road-poneglyph-mcp
```
这安装了 `road-poneglyph` 命令。
然后使用您的MCP客户端注册它 — 运行 `claude mcp add road-poneglyph -- road-poneglyph`，或将以下内容添加到客户端的配置文件（例如 `claude_desktop_config.json`）：
```json
{
"mcpServers": {
"road-poneglyph": { "command": "road-poneglyph" }
}
}
```
重启客户端，工具即可使用。
## 大航线栈
路标碑文是四工具集的一部分。每个工具都独立存在，但安装所有工具可通过 **笑谈** 解锁最终惊喜。
| | 包 | |
|---|---|---|
| 🗿 | [`road-poneglyph`](https://github.com/xfloukiex-lab/road-poneglyph) | 路标碑文 · **← 本仓库** |
| ⚔️ | [`conquerors-haki`](https://github.com/xfloukiex-lab/conquerors-haki) | 征服者的武装色霸气 |
| ⏳ | [`toki-toki`](https://github.com/xfloukiex-lab/toki-toki) | 时钟果实 |
| 🏴☠️ | [`laugh-tale`](https://github.com/xfloukiex-lab/laugh-tale) | 笑谈 |
## 开发
```bash
git clone https://github.com/xfloukiex-lab/road-poneglyph
cd road-poneglyph
python -m venv .venv && . .venv/Scripts/activate # macOS/Linux: source .venv/bin/activate
pip install -e ".[dev]"
python tests/test_road_poneglyph.py
```
## 归属与许可
在 **Apache-2.0** 许可下发布。图标是原创艺术作品（参见 `icon.svg`），在本地生成；仓库不包含任何第三方资产。
*本项目是粉丝自发创作的项目。它与《海贼王》的创作者或权利持有者（尾田荣一郎 / 集英社 / 东映动画）无关，也未获得他们的赞助或认可。《海贼王》及相关名称仅作为主题装饰使用，仍归属于其各自的所有者。*
