内容
# deploychan MCP
公共远程MCP服务器，封装了 **KISA 精心策划的编程体验** —
知识、现成的技能、升级路线和推荐 — 并将其提供给任何
编码代理，访问地址只需一个URL。
- **端点：** `https://mcp.deploychan.webcam/mcp`
- **传输：** 可流式HTTP · **访问：** 公共，只读，无需登录，无需密钥
- **许可证：** MIT · 所有内容（网站、服务器、数据库）都是开源的
> 将您的代理指向端点，它将获得 `search_knowledge`、`get_item`、
> `list_skills`、`get_skill`、`onboard`、`next_step` 和 `list_recommended`。
## 连接
**Claude 代码**
```bash
claude mcp add --transport http deploychan https://mcp.deploychan.webcam/mcp
```
**Codex** (`~/.codex/config.toml`)
```toml
[mcp_servers.deploychan]
url = "https://mcp.deploychan.webcam/mcp"
transport = "http"
```
**Hermes / 通用** (`mcp.json`)
```json
{
"mcpServers": {
"deploychan": {
"type": "http",
"url": "https://mcp.deploychan.webcam/mcp"
}
}
}
```
## 代理获取的内容
| 方面 | 工具 | 返回内容 |
|---|---|---|
| 知识 | `search_knowledge(query)` · `get_item(id)` | 搜索片段，然后通过ID获取完整指南。 |
| 技能 | `list_skills()` · `get_skill(id)` | 现成软件包：步骤、配置、检查清单。 |
| 升级 | `onboard(goal)` · `next_step(step_id)` | 针对目标的有序路线；每个步骤的材料。 |
| 推荐 | `list_recommended()` | KISA 精心策划的跨类型精选。 |
## 自主托管
所有内容都是开源的。运行您自己的实例 — 本地或在VPS上 — 使用您自己的
内容。
```bash
git clone https://github.com/howdeploy/deploychan_mcp
cd deploychan_mcp
docker compose up -d --build
# -> 您的MCP：http://localhost:8080/mcp
```
服务器故意绑定到环回地址 (`127.0.0.1:8080`) — 为公共部署添加反向代理（TLS +
限速）。
## 内容
所有内容都是手艺精湛的Markdown，带有YAML前置信息，位于 `content/` 下：
```
content/skills/<id>/SKILL.md # 可安装的技能包
content/knowledge/<id>.md # 笔记/指南（全文可搜索）
content/routes/<id>.md # 升级路线（有序步骤）
content/tools/<id>.md # 第三方工具安装指南
content/meta.yml # 端点、连接代码段、配置文件
```
`ingest` 将 `content/` 加载到SQLite + FTS5，并为站点生成 `web/catalog.json`:
```bash
python -m server.ingest
```
搜索仅限全文（FTS5）— 离线，无需嵌入，无需API密钥。 `content/` 中的所有内容都是公开的；请勿在其中放置私人数据。
## 开发
```bash
pip install -e ".[dev]"
python -m server.ingest # 构建数据库 + 目录
pytest # 运行测试
python -m server.app # 在 http://localhost:8080/mcp 上本地服务
```
## 安全
设计上只读：服务器提供内容，不在您的机器上运行任何程序。无需登录，
无需密钥，无需请求历史记录存储。技能是Shell命令和配置，代理在
**您的机器上**运行 — 在批准之前请阅读技能的内容，并将第三方
技能视为不受信任的代码。
