Metadata-Version: 2.4
Name: sophonsai-worklog-mcp-server
Version: 0.2.0
Summary: MCP server for SophonsAI work logs
Author-email: zikang <zikang549603026@gmail.com>
License-Expression: MIT
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Requires-Dist: httpx<1,>=0.27
Requires-Dist: mcp<2,>=1.8
Description-Content-Type: text/markdown

# SophonsAI Worklog MCP Server (Python)

通过 [PyPI](https://pypi.org/project/sophonsai-worklog-mcp-server/) 分发的 stdio MCP Server，代理 SophonsAI 工作日志 API。

## 用户使用

### 1. 获取 TOKEN

登录 SophonsAI，在「个人中心」生成专属 TOKEN。

### 2. 配置 MCP 客户端

任选一种方式。

#### 方式 A：`uvx`（推荐，无需手动 pip install）

先装 [uv](https://docs.astral.sh/uv/)（已装可跳过）：

```powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```

然后在 MCP 客户端配置中添加：

```json
{
  "mcpServers": {
    "worklog": {
      "command": "uvx",
      "args": ["sophonsai-worklog-mcp-server"],
      "env": {
        "TOKEN": "<在 SophonsAI 个人中心生成的 TOKEN>"
      }
    }
  }
}
```

#### 方式 B：`pip install` + entry point

```bash
pip install sophonsai-worklog-mcp-server
```

```json
{
  "mcpServers": {
    "worklog": {
      "command": "sophonsai-worklog-mcp-server",
      "env": {
        "TOKEN": "<在 SophonsAI 个人中心生成的 TOKEN>"
      }
    }
  }
}
```

### 关于 SERVER_URL

默认指向 `https://worklog.sophonsai.com`。如果你要指向别的环境（自建部署、测试环境等），在 `env` 里覆盖：

```json
"env": {
  "TOKEN": "...",
  "SERVER_URL": "https://your-custom-host"
}
```

## 提供的工具

- `get-current-user-work-logs` — 获取当前用户的日志记录，可按日期和项目筛选
- `create-a-work-log` — 创建一条日志记录（workHour 取值 1–24）
- `update-a-work-log` — 修改一条日志记录，按 id 指定，仅传需要修改的字段（workHour 取值 1–24）
- `delete-a-work-log` — 删除一条日志记录，只能删除当前用户自己的日志
- `get-company-project-list` — 获取当前用户所属公司的项目列表

请求会以 `TOKEN` 作为 `Authorization` 请求头转发到 `SERVER_URL` 下的工作日志 API。

## 开发

要求 Python 3.10+。

```bash
python -m venv .venv
.venv\Scripts\activate
python -m pip install -e .
```

本地调试建议用 MCP inspector：

```bash
mcp dev src/worklog_mcp_server/server.py
```

## 发布新版本

```bash
.venv\Scripts\python -m build
.venv\Scripts\twine upload dist\*
```

> 发布前记得 bump `pyproject.toml` 里的 `version`，并清空旧的 `dist/`。