MCP server for kintone by Deno サンプル

kintone MCP 服务 Deno 示例

这是一个使用 Deno 实现的 MCP 服务示例，可将 Claude Desktop 与 kintone 集成。 可以使用 AI 操作和分析 kintone 数据。

仓库：https://github.com/r3-yamauchi/kintone-deno-mcp-server

🌟 特点

• 🔒 安全的设计：借助 Deno 的权限系统，仅允许与指定的 kintone 域名通信
• 🚀 丰富的工具：实现了 19 个工具，涵盖记录操作、评论、状态和文件操作等
• 📦 简单的结构：所有功能都集中在单个文件（server.js）中
• 🎯 类型安全：支持 TypeScript 类型检查

📋 必要条件

• Deno v2.0 及更高版本（推荐：v2.3 及更高版本）
• Claude Desktop 应用程序（最新版）
• 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 | sh

2. 确认运行

在演示环境中确认运行：

# 環境変数を設定してサーバー起動
export KINTONE_DOMAIN=dev-demo.cybozu.com
export KINTONE_USERNAME=demo-guest
export KINTONE_PASSWORD=demo-guest
deno task start

3. 配置 Claude Desktop

配置文件位置

OS	路径
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%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 --version

2. 身份验证错误（401 Unauthorized）

# 確認項目
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」是 Cybozu, Inc. 的注册商标
• 支持：本项目是社区项目，不提供 Cybozu, Inc. 的官方支持
• API 限制：请注意 kintone API 的速率限制

🔗 相关链接

• Model Context Protocol
• kintone API 文档
• Deno 官方网站
• Claude