关键词

kintone数据访问AI工具Claude Desktop企业数据

项目简介

macrat-mcp-server-kintone 是一个基于 Model Context Protocol (MCP) 构建的服务器，专门为 kintone 设计。它允许 AI 工具（如 Claude Desktop）安全地访问和操作存储在 kintone 中的企业数据。通过此服务器，用户可以使用自然语言指令，让 AI 工具与 kintone 数据进行交互，例如查询客户信息、更新项目进度等。

主要功能点

  • 数据访问桥梁: 作为 MCP 服务器，它充当 AI 工具和 kintone 之间的桥梁，使得 AI 工具能够以标准化的方式访问 kintone 数据。
  • 资源管理: 将 kintone 应用视为资源进行管理，允许客户端通过服务器访问指定的 kintone 应用数据。
  • 工具集成: 内置了一系列预定义的工具，例如列出应用、读取应用信息、创建/读取/更新/删除记录、管理记录评论等，使 AI 工具具备操作 kintone 的能力。
  • 权限控制: 通过配置文件管理可以访问的 kintone 应用以及相应的读写权限，保障数据安全。
  • 易于部署: 提供预编译的可执行文件，配置简单，可以快速部署并与 MCP 客户端连接。

安装步骤

  1. 下载: 访问 Releases 页面 下载最新版本的 'mcp-server-kintone' 可执行文件。
  2. 放置: 将下载的可执行文件放置到您希望的任意目录。

服务器配置

  1. 创建配置文件: 在与 'mcp-server-kintone' 可执行文件相同的目录或您指定的目录下，创建一个 JSON 格式的配置文件（例如 'configuration.json'）。

  2. 编辑配置文件: 根据您的 kintone 环境，编辑配置文件，填入以下信息：

    {
    "url": "https://<您的kintone域名>.cybozu.com",
    "username": "<您的用户名>",
    "password": "<您的密码>",
    "token": "<您的应用令牌1>,<您的应用令牌2>,...",
    "apps": [
        {
            "id": "<应用ID>",
            "description": "<应用描述，用于AI理解>",
            "permissions": {
                "read": true,
                "write": false,
                "delete": false
            }
        }
    ]
}

    配置参数说明:

    • 'url': (必填) 您的 kintone 域名 URL。
    • 'username': (可选) 用于登录 kintone 的用户名。
    • 'password': (可选) 用于登录 kintone 的密码。
    • 'token': (可选) 用于登录 kintone 的应用令牌，多个令牌请用逗号分隔。
    • 'apps': (必填) 您希望 AI 工具访问的 kintone 应用列表。
      • 'id': (必填) 应用 ID。
      • 'description': (可选) 应用描述，用于帮助 AI 理解应用内容。
      • 'permissions': (可选) AI 工具对该应用的权限设置。
        • 'read': (可选) 是否允许读取数据，默认为 'true'。
        • 'write': (可选) 是否允许写入数据，默认为 'false'。
        • 'delete': (可选) 是否允许删除数据，默认为 'false'。

    注意: 必须提供用户名/密码组合或应用令牌才能连接到 kintone。为了安全起见，服务器仅允许客户端访问配置文件中明确列出的应用。

MCP 客户端配置 (以 Claude Desktop 为例)

  1. 打开配置文件: 找到 Claude Desktop 的配置文件并打开编辑：

    • MacOS/Linux: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
    • Windows: '%APPDATA%\Claude\claude_desktop_config.json'

  2. 添加 MCP 服务器配置: 在 'claude_desktop_config.json' 文件中的 'mcpServers' 部分添加以下配置：

    {
  "mcpServers": {
    "kintone": {
      "command": "<mcp-server-kintone 可执行文件的路径>",
      "args": [
        "<configuration.json 配置文件的路径>"
      ]
    }
  }
}

    配置参数说明:

    • 'command': 'mcp-server-kintone' 可执行文件的绝对路径。
    • 'args': 包含配置文件路径的参数数组，此处为 'configuration.json' 文件的绝对路径。

    例如:

    {
  "mcpServers": {
    "kintone": {
      "command": "C:\\path\\to\\mcp-server-kintone.exe",
      "args": [
        "C:\\path\\to\\configuration.json"
      ]
    }
  }
}

  3. 重启 Claude Desktop: 保存配置文件并重启 Claude Desktop 使配置生效。

基本使用方法

配置完成后，您就可以在 Claude Desktop 中使用自然语言与 kintone 数据进行交互了。例如：

  • "Customer A's project 的最新状态是什么？"
  • "将 Project B 的进度更新为 50%。"
  • "显示所有进度落后的项目。"

Claude Desktop 会将您的指令转换为对 MCP 服务器的请求，服务器会调用相应的 kintone API 获取或操作数据，并将结果返回给 Claude Desktop。

信息

分类

商业系统

访问项目