kintone MCP Server for Deno 样本
Claude Desktop 打开 金色调 协作Deno 根据…；根据MCP Server 的规格化距离的幂函数。 kintone数据AI中所述修改相应参数的值。
存储库:
🌟 特徴
- 🔒 安全设计: Deno的权限系统指定的kintone仅允许与域通信
- 🚀 丰富的工具：实现记录操作、注释、状态、文件操作等19个工具
- 📦 简单的配置：将所有功能聚合到单个文件中
- 🎯 型安全: TypeScript的类型检查
📋 必要要件
- 德诺 v2.0以降（推奨: v2.3以降）
- 克劳德桌面 应用程序（最新版本）
- kintone帐户（需要对应用程序的访问权限）
🚀 快速启动
1.安装
# リポジトリのクローン
git clone https://github.com/r3-yamauchi/kintone-deno-mcp-server.git
cd kintone-deno-mcp-server
# Denoのインストール（未インストールの場合）
curl -fsSL https://deno.land/install.sh | sh2.动作确认
在演示环境中检查行为：
# 環境変数を設定してサーバー起動
export KINTONE_DOMAIN=dev-demo.cybozu.com
export KINTONE_USERNAME=demo-guest
export KINTONE_PASSWORD=demo-guest
deno task start3. Claude Desktop设定
配置文件位置
| OS | 路径 |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| 窗户 | %APPDATA%\Claude\claude_desktop_config.json |
| Linux | ~/.config/Claude/claude_desktop_config.json |
设定例
{
"mcpServers": {
"kintone": {
"command": "deno",
"env": {
"KINTONE_DOMAIN": "your-subdomain.cybozu.com",
"KINTONE_USERNAME": "your-username",
"KINTONE_PASSWORD": "your-password"
},
"args": [
"run",
"--allow-env",
"--allow-net=your-subdomain.cybozu.com",
"/absolute/path/to/server.js"
]
}
}
}设置要点
KINTONE_DOMAIN:https://不需要，只指定子域--allow-net：出于安全考虑，必须仅允许特定域- 路径：server.js的绝对路径（相对路径不可用）
4.再起动
Claude Desktop完全退出并重新启动（从系统托盘退出）
📚 使用方法
基本用法
Claude Desktop可以用以下自然的日语操作：
「顧客管理」アプリの全レコードを取得して
アプリID 10 で会社名に「サイボウズ」を含むレコードを検索して
「営業日報」アプリに新しいレコードを作成して
件名: 本日の活動報告
内容: 新規顧客3社訪問
レコードID 100 のステータスを「承認済み」に更新して高级用法
# 複数レコードの一括作成
10件のテストデータを「商品マスタ」アプリに登録して
# 条件検索とフィールド指定
「受注管理」アプリで今月作成されたレコードの
「顧客名」「金額」「ステータス」フィールドだけ取得して
# コメント操作
レコードID 50 に「確認しました」とコメントを追加して🛠️ 19个可用工具
记录操作（7个）
｜工具名称｜说明｜主要用途｜ |---------|------|----------| | get_record ｜获取单个记录｜详细确认特定记录｜ | search_records 查找记录｜查找符合条件的记录｜ | get_all_records ｜自动获取所有记录｜数据分析、批量处理｜ | create_record ｜记录制作｜新数据登录｜ | add_records 多条记录批量制作｜大量数据的导入｜ | update_record 记录更新｜修改现有数据｜ | update_records 多记录批量更新｜批量修改大量数据｜
注释状态（4个）
｜工具名称｜说明｜主要用途｜ |---------|------|----------| | get_comments ｜获取注释一览｜确认交流历史｜ | add_comment ｜添加注释｜添加反馈注释｜ | update_status ｜状态更新｜工作流进度｜ | update_statuses ｜多状态成批更新｜大量批准处理｜
应用程序字段信息（4个）
｜工具名称｜说明｜主要用途｜ |---------|------|----------| | get_app 获取应用程序详细信息｜确认应用程序设置｜ | get_apps 获取应用程序列表查看可用应用程序 | get_apps_info 应用程序名称搜索ID的特定 | get_form_fields ｜字段定义获取｜确认架构信息｜
文件操作（2个）
｜工具名称｜说明｜主要用途｜ |---------|------|----------| | upload_file 文件上载｜附件的注册｜ | download_file 下载文件，获取附件
🔧 故障排除
常见问题及解决办法
1. MCP未检测到服务器
# 確認項目
1. Claude Desktopを完全に終了（タスクトレイも確認）
2. 設定ファイルのJSONが正しいか確認
3. server.jsのパスが絶対パスか確認
4. Denoがインストールされているか確認
deno --version2.验证错误（401Unauthorized）
# 確認項目
1. ユーザー名・パスワードの確認
2. ドメイン名の確認（https://は不要）
3. アプリへのアクセス権限の確認
4. IPアドレス制限の確認3.网络错误
# 確認項目
1. --allow-netフラグにドメインが正しく指定されているか
2. プロキシ設定が必要な環境か
3. kintoneのメンテナンス情報を確認4.数据获取错误
# 確認項目
1. アプリIDが正しいか
2. フィールドコードが正しいか
3. レコード数が多すぎないか（自動分割は動作するか）🧑💻 开发人员信息
项目配置
kintone-deno-mcp-server/
├── server.js # MCPサーバー実装（約1300行）
├── deno.json # Deno設定ファイル
├── import_map.json # インポートマップ（将来の拡張用）
├── package.json # npm互換性のためのメタデータ
├── LICENSE # MITライセンス
├── README.md # このファイル
├── CLAUDE.md # Claude Code向け開発ガイド
└── .gitignore # Git除外設定开发指令
# サーバー起動
deno task start
# コード整形
deno fmt
# Lint実行
deno lint
# 型チェック
deno check server.js
# 依存関係の更新確認
deno run --allow-net https://deno.land/x/udd/main.ts server.js体系结构
- 单一文件设计：简化维护和部署
- 域驱动设计：明确的责任分离
- 错误处理：详细日志输出
- 型安全: TypeScript型推理活用
📄 许可证
这个项目MIT许可证的明细栏样式中定义的设置。
⚠️ 注意事项
- 安全性：密码以明文形式保存，请设置适当的文件访问权限
- 商标：“kintone”是赛博股份有限公司的注册商标
- 支持：本项目为社区项目，无赛博股份有限公司官方支持
- API制限: kintone API的汇率限制