SophonsAI Worklog MCP Server (Python)

通过 PyPI 分发的 stdio MCP Server，代理 SophonsAI 工作日志 API。

用户使用

1. 获取 TOKEN

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

2. 配置 MCP 客户端

任选一种方式。

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

先装 uv（已装可跳过）：

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

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

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

方式 B：pip install + entry point

pip install sophonsai-worklog-mcp-server

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

关于 SERVER_URL

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

"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+。

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

本地调试建议用 MCP inspector：

mcp dev src/worklog_mcp_server/server.py

发布新版本

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

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