# xy_mcp

**Repository Path**: godY/xy_mcp

## Basic Information

- **Project Name**: xy_mcp
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-04
- **Last Updated**: 2026-11-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 秀依 MCP（shoin-quicklog）

秀依 Lifecycle OS（v1.0.5）的功能封装为本地 stdio MCP：微信 → Hermes → 本 MCP → 秀依 `/api/v1`。

> **功能总表（30 个工具 + 语音用法）见 [`docs/mcp-feature-table.md`](docs/mcp-feature-table.md)**
> 项目/系统/凭据/红线见 [`AGENTS.md`](AGENTS.md)

## 主要能力

- **拜访快录**：记录/查询/补充/删除（`supplement` 追加「（补充 日期）…」，原文一字不改）
- **任务**：给项目创建任务、查我的任务（状态/项目/逾期过滤）、改状态（待开始/开发中/评审中/已完成/已取消）、改内容
- **工作台/经营总览/日历**：今天盯什么、公司大盘、本周日程
- **客户/线索/项目/风险**：搜索、详情、列表、风险认领/解除（两步确认）
- **周报素材**：`shoin_weekly_digest` 汇总一段时间里的事件+任务进展（不调 AI）

## 安装

```bash
npm install
npm run build          # → dist/
hermes -p zhaofeng mcp test shoin-quicklog   # 工具数应为 30
```

注册（一次性，`--env` 必须在 `--args` 之前）：

```bash
hermes -p zhaofeng mcp add shoin-quicklog --command node --args /workspace/xy/dist/index.js \
  --env SHOIN_BASE_URL=… SHOIN_EMAIL=… SHOIN_PASSWORD=…
hermes -p zhaofeng gateway restart   # 代码更新后都要；旧会话无需 /new
```

## 约定

- 凭据只走环境变量，不写入仓库/日志
- 写操作直接落生产库：不自动重试、不自动猜；信息不全先追问，歧义先列候选
- 删除/解除类工具走两步确认（先预览，`confirm: true` 后执行）
- 列表页大多返回裸数组；`/events` 返回 `{list,total,visibleTotal}`；`/risks` 返回 `{list,summary}`
- `types=` 是**复数逗号分隔**

## 现状

2026-11-06：30 个工具全部实现；只读逐项联调通过（演示主机 `http://144.123.172.146:20168/`）；设计与历史背景见 `docs/superpowers/specs/2026-11-04-shoin-quicklog-mcp-design.md`、`docs/handover-2026-11-04-shoin-quicklog.md`。