# easypm-skill

> 把 [EasyPM](https://easypm.yiproject.com) 接入任何支持 MCP 协议的本地 Agent（Claude Desktop / Cursor / Windsurf / Cline / Trae 等）。

这个仓库是 **agent 端的薄壳包**，真正的 MCP server + CLI 在 [kattle/EasyPM](https://github.com/kattle/EasyPM) 仓库的 `packages/openapi` 下开发、build、版本管理。这里只负责暴露 npm 上的 `easypm-skill` 一个名字，方便 `npx easypm-skill` / `npm i -g easypm-skill` 一行命令安装。

## 为什么独立仓库？

业务仓库里 MCP server 是 `private: true`（monorepo 内部消费），永远不会被 npm publish。把"装给 agent 用"的薄壳挪到独立仓库，让 npm 用户只需拉几 KB 的 SKILL.md + 包壳，不必 clone 整个 monorepo 还得 `pnpm install` + build。

## 安装

### Claude Desktop

`~/.config/claude/mcp.json`：

```json
{
  "mcpServers": {
    "easypm": {
      "command": "npx",
      "args": ["-y", "easypm-skill"],
      "env": {
        "EASYPM_API_KEY": "eapk_live_xxx",
        "EASYPM_CLIENT_ID": "eacli_xxx"
      }
    }
  }
}
```

### CLI

```bash
npm install -g easypm-skill
easypm login
easypm projects list
```

凭证获取：https://easypm.yiproject.com/settings → 开放平台 → 应用详情 → 创建 Key。

## 完整文档

- 开发者门户：https://easypm.yiproject.com/openapi/portal
- OpenAPI 3.1 spec：https://easypm.yiproject.com/openapi/v1/openapi.json
- 业务仓库：https://github.com/kattle/EasyPM

## 升级流程

薄壳版本号永远跟随主仓 `@easypm/mcp` 版本。每次主仓 release：

1. 主仓打 tag（如 `mcp/v0.3.0`）→ CI 自动 publish `@easypm/mcp` 到 npm
2. 本仓 bump `package.json` 的 `dependencies."@easypm/mcp"` 到对应版本
3. 本仓打 tag → CI 自动 publish `easypm-skill` 到 npm

## License

MIT