🚀 MCP 服务器用于 cli-kintone
本项目是一个实验性仓库，主要探索将 cli-kintone 转化为 MCP（模型上下文协议）服务器的可能性，为 kintone 应用相关操作提供便利。
🚀 快速开始
本项目旨在探索将 cli-kintone 转化为 MCP 服务器的可能性。下面为你介绍如何快速开启项目。
✨ 主要特性
目前，该 MCP 服务器支持以下功能：
- 获取记录：可从 kintone 应用中检索所需记录。
📦 安装指南
你可以按照以下步骤完成项目的安装：
# 克隆仓库
git clone https://github.com/r3-yamauchi/mcp-server-cli-kintone-experimental.git
cd mcp-server-cli-kintone-experimental
# 安装依赖项
npm install
# 构建
npm run clean:lib && npm run build:mcp
💻 使用示例
基础用法
1. MCP 配置文件的创建
你可以使用用户名和密码进行身份验证，配置如下：
{
"mcpServers": {
"kintonecli": {
"command": "node",
"args": ["/path/to/mcp-server-cli-kintone/start-mcp-server.mjs"],
"env": {
"KINTONE_DOMAIN": "your-domain.cybozu.com",
"KINTONE_USERNAME": "username",
"KINTONE_PASSWORD": "password"
}
}
}
}
也可以使用 API 令牌进行身份验证，配置如下：
{
"mcpServers": {
"kintonecli": {
"command": "node",
"args": ["/path/to/mcp-server-cli-kintone/start-mcp-server.mjs"],
"env": {
"KINTONE_DOMAIN": "your-domain.cybozu.com",
"KINTONE_API_TOKEN": "your-api-token1,your-api-token2,your-api-token3"
}
}
}
}
2. 关于 API 令牌的限制
⚠️ 重要提示
在 kintone 的 API 请求中，一次请求最多可以指定9个 API 令牌。超过10个将导致错误。此 MCP Server 支持以逗号分隔的最大9个 API 令牌。如果指定超过10个 API 令牌，将会报错，请注意。
KINTONE_API_TOKEN="token1,token2,token3,token4,token5,token6,token7,token8,token9"
3. MCP 配置文件的放置位置
- Claude Desktop App：
~/Library/Application Support/Claude/claude_desktop_config.json - Claude VSCode 扩展：
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
4. AI 助手的使用
AI 助手可以通过以下方式调用此工具：
use_mcp_tool({
server_name: "kintonecli",
tool_name: "get_records",
arguments: {
app: "アプリID",
query: "作成日時 > \"2025-01-01\"",
fields: ["フィールド1", "フィールド2"]
}
});
或者直接指定域和 API 令牌：
use_mcp_tool({
server_name: "kintonecli",
tool_name: "get_records",
arguments: {
domain: "your-domain.cybozu.com",
apiToken: "your-api-token1,your-api-token2,your-api-token3",
app: "アプリID",
query: "作成日時 > \"2025-01-01\"",
fields: ["フィールド1", "フィールド2"]
}
});
📚 详细文档
未来计划
本项目后续有以下开发计划：
- 创建新记录：可在 kintone 应用中创建新记录。
- 更新记录：对 kintone 应用中的现有记录进行更新。
- 删除记录：删除 kintone 应用中的指定记录。
- 获取应用信息：检索 kintone 应用的相关信息。
📄 许可证
本项目采用 MIT License。
⚠️ 免责声明
MCP、kintone 以及相关标识是 sap HEAVY industries 的注册商标。