MCP Kintone Lite

mcp-kintone-lite

简单轻便的Kintone MCP服务器，用于将AI助手连接到Kintone应用程序和数据。非常适合自动化工作流程并将Kintone与AI工具集成。

](https://pypi.org/project/mcp-kintone-lite/)   ](https://github.com/luvl/mcp-kintone-lite/stargazers)

📦 从PyPI安装： pip install mcp-kintone-lite

🔗 PyPI包： https://pypi.org/project/mcp-kintone-lite/

📚 GitHub存储库： https://github.com/luvl/mcp-kintone-lite

演示

查看MCP Kintone Lite服务器与Claude Desktop的运行情况：

Kintone MCP Demo

*该演示展示了Claude Desktop使用MCP服务器与Kintone数据交互——无缝查询应用程序、检索记录和执行CRUD操作。*

概述

此MCP（模型上下文协议）服务器为Claude等AI助手提供对Kintone应用程序和数据的安全访问。它实现了MCP标准，实现了AI应用程序和Kintone业务流程平台之间的无缝集成。

特性

• 🔐 通过基本身份验证（用户名/密码）进行安全的Kintone身份验证
• 📊 访问所有Kintone应用程序（基于用户权限）
• 🔍 使用过滤和分页执行查询
• 📝 Kintone记录的CRUD操作
• 🛡️ 内置安全性和验证
• 🚀 易于设置和配置

快速使用

# Install the package
pip install mcp-kintone-lite

# Use with Claude Desktop (recommended)
uvx --from mcp-kintone-lite mcp-kintone-lite

# Or run directly
mcp-kintone-lite

适用于： Claude Desktop，任何兼容MCP的人工智能助手

Claude Desktop快速入门

生产使用（推荐）

使用此MCP服务器的最简单方法是直接从PyPI安装它，并使用Claude Desktop进行配置。

步骤1：配置Claude桌面

将以下配置添加到您的Claude Desktop设置文件中：

配置文件位置：

• macOS/Linux： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

配置：

{
  "mcpServers": {
    "kintone-lite": {
      "command": "uvx",
      "args": [
        "--from",
        "mcp-kintone-lite",
        "mcp-kintone-lite"
      ],
      "env": {
        "KINTONE_SUBDOMAIN": "your-subdomain",
        "KINTONE_USERNAME": "your-username",
        "KINTONE_PASSWORD": "your-password"
      }
    }
  }
}

步骤2：设置Kintone凭据

替换配置中的环境变量：

• KINTONE_SUBDOMAIN：您的Kintone子域（例如。， mycompany 为了 mycompany.cybozu.com)
• KINTONE_USERNAME：您的Kintone用户名
• KINTONE_PASSWORD：您的Kintone密码

步骤3：重新启动克劳德桌面

保存配置后，重新启动Claude Desktop。您应该看到一个锤子图标，表示工具可用。

步骤4：测试集成

试着问克劳德：

• “列出可用的Kintone应用程序”
• “获取应用123的表单字段”
• “从状态为“活动”的应用456获取记录”

先决条件

• Python 3.10或更高版本
• 带有用户名和密码的Kintone帐户
• Kintone子域（例如。， yourcompany.cybozu.com)

开发设置

如果您想修改或贡献此MCP服务器，请按照以下开发设置说明进行操作。

安装

选项1：使用紫外线（建议用于开发）

# Install uv if you haven't already
brew install uv  # macOS
# or
curl -LsSf https://astral.sh/uv/install.sh | sh  # Linux/macOS

# Clone and install the server
git clone https://github.com/luvl/mcp-kintone-lite.git
cd mcp-kintone-lite
uv sync

选项2：使用诗歌

git clone https://github.com/luvl/mcp-kintone-lite.git
cd mcp-kintone-lite
poetry install

Kintone开发设置

创建一个 .env 项目根目录中的文件：

KINTONE_SUBDOMAIN=your-subdomain
KINTONE_USERNAME=your-username
KINTONE_PASSWORD=your-password

用法

开发模式

首先，确保您的Kintone凭据已在您的 .env 文件。

方法1：直接执行Python

# Run the server directly
python src/mcp_kintone_lite/server.py

方法二：用诗

# Run with Poetry
poetry run python src/mcp_kintone_lite/server.py

方法3：使用紫外线（推荐）

# Run with UV
uv run python src/mcp_kintone_lite/server.py

MCP检验员测试

如果安装了MCP CLI，则可以测试服务器：

# Test with MCP Inspector
mcp inspector

# Or run in development mode
mcp dev src/mcp_kintone_lite/server.py

出版流程

1. 首先在TestPyPI上进行测试:

# Build the package
uv build
# or: poetry build

# Upload to TestPyPI
twine upload --repository testpypi --config-file .pypirc dist/*

# Test install from TestPyPI
pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ mcp-kintone-lite

1. 发布到生产PyPI:

# Upload to production PyPI
twine upload --repository pypi --config-file .pypirc dist/*

# Test install from production PyPI
pip install mcp-kintone-lite

版本管理

要发布新版本，请执行以下操作：

1. 更新中的版本 pyproject.toml
2. 重建： uv build 或 poetry build
3. 上传： twine upload --repository pypi --config-file .pypirc dist/*