Skip to content

v1.0.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 12 Apr 10:50
· 46 commits to main since this release
v1.0.0
07267cb

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[Unreleased]

1.0.0 - 2026-04-12

Added

Core MCP tools (11 total)

Tool Type Description
query_bill query 按字段键列表查询单据，支持过滤、排序、分页
query_bill_json query 查询单据并返回完整 JSON 字段（适合字段名未知时探索）
view_bill query 按单据 ID 或单号查询单条完整单据
query_metadata query 查询表单元数据与字段定义
query_by_number query 批量按单号查询单据
query_business_info query 查询扩展业务数据视图
save_bill write 新建或更新单据
submit_bill write 提交单据审批
audit_bill write 审核通过单据
unaudit_bill write 撤销单据审核
delete_bill write 删除草稿单据
execute_operation write 调用金蝶 K/3 Cloud 任意业务操作
push_bill write 单据下推，将源单转换为下游单据类型

Transport & auth

  • Three transport protocols: stdio (default), SSE, streamable-http
  • Optional Bearer-token authentication via MCP_API_KEY env var (SSE / streamable-http only); stdio mode is unaffected
  • --mode readonly flag (and MCP_MODE=readonly env var) to expose only the 4 query tools — safe for read-only deployments

Session management

  • RetryableK3CloudApiSdk: automatic session recovery when K/3 Cloud returns "会话信息已丢失"
  • Fire-and-forget SID reset: on expiry, clears stale cookiesStore and makes one call to establish a fresh SID; returns the error immediately instead of blocking
  • 300-second cooldown prevents back-to-back resets from destroying a newly-issued SID before it activates server-side
  • Unicode-escaped session expiry messages correctly detected (\u4f1a\u8bdd...)
  • hasattr guard on cookiesStore reset for forward-compatibility with future SDK versions

Package & tooling

  • Proper src/ layout, fully PEP 621 compliant pyproject.toml
  • Dependency upper bounds: kingdee-cdp-webapi-sdk>=8.2.0,<9, mcp>=1.26.0,<2, python-dotenv>=1.2.1,<2
  • py.typed marker for downstream mypy support
  • Apache 2.0 license
  • GitHub Actions CI matrix (Python 3.10 / 3.11 / 3.12)
  • GitHub Actions release workflow with PyPI Trusted Publishing (OIDC)

Full Changelog: https://github.com/adamzhang1987/kingdee-k3cloud-mcp/commits/v1.0.0

Assets 7
Loading