k3cloud-query-mcp

金蝶云星空 K3Cloud MCP 查询服务（纯查询版）—— 让 AI 助手通过自然语言查询金蝶 ERP 数据。

特性

特性	k3cloud-query-mcp
查询工具	✅ 8 个
写入/操作工具	❌ 已移除
适用场景	纯查询

查询工具列表

工具	说明
`query_bill`	查询单据数据（二维数组）
`query_bill_json`	查询单据数据（JSON 对象数组）
`count_bill`	估算查询条件下的数据行数
`query_bill_all`	自动翻页查询（≤ 数千行）
`query_bill_to_file`	大数据量流式导出到文件
`query_bill_range`	按日期分片查询（跨月/跨年）
`view_bill`	查看单条记录完整详情
`query_metadata`	查询表单字段元数据

安装

pip install k3cloud-query-mcp

或使用 uv：

uv add k3cloud-query-mcp

配置

在项目根目录创建 .env 文件：

KD_ACCT_ID=your_acct_id
KD_USERNAME=your_username
KD_APP_ID=your_app_id
KD_APP_SEC=your_app_secret
KD_SERVER_URL=https://your-server/k3cloud/
KD_LCID=2052

使用

Claude Desktop 配置

{
  "mcpServers": {
    "k3cloud-query": {
      "command": "uvx",
      "args": ["k3cloud-query-mcp"],
      "env": {
        "KD_ACCT_ID": "your_acct_id",
        "KD_USERNAME": "your_username",
        "KD_APP_ID": "your_app_id",
        "KD_APP_SEC": "your_app_secret",
        "KD_SERVER_URL": "https://your-server/k3cloud/"
      }
    }
  }
}

SSE 模式

k3cloud-query-mcp --transport sse

开发

# 安装依赖
uv sync

# 运行
uv run k3cloud-query-mcp

# 测试
make test

# 代码检查
make lint

# 格式化
make format

Metadata

Release files for k3cloud-query-mcp 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for k3cloud-query-mcp 1.0.0
File	Size	Uploaded
k3cloud_query_mcp-1.0.0.tar.gz	16.0 kB	Jul 23, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for k3cloud-query-mcp 1.0.0
File	Interpreter	ABI	Platform	Reset
k3cloud_query_mcp-1.0.0-py3-none-any.whl 14.8 kB Jul 23, 2026	Python 3	none	any	Details

Total release size: 30.7 kB

Release files / k3cloud_query_mcp-1.0.0.tar.gz

Download URL	k3cloud_query_mcp-1.0.0.tar.gz
Size	16.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`6647921aa63f0f2e8d1def9d954d574bc00dec409ac3ae72cbcb3703219e5423`
BLAKE2b-256 checksum How to use checksums	`2bbbc0b59abbf6770c0d9ee2d4a18c15479014b92278b840e0c8fa4dac838b47`
Upload date	Jul 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / k3cloud_query_mcp-1.0.0-py3-none-any.whl

Download URL	k3cloud_query_mcp-1.0.0-py3-none-any.whl
Size	14.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`47b6e01e6ef78774c3c72df860cf38e996e397fcbaf2a45edef1c6daaa412b15`
BLAKE2b-256 checksum How to use checksums	`c1f97d6eeb380311f58354f4e9c10b7cf125b79e75874b6a81deebcf96037551`
Upload date	Jul 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release history Release notifications | RSS feed

This release

1.0.0 This release

Jul 23, 2026 2 release files

k3cloud-query-mcp 1.0.0