MCP Server Cli Kintone Experimental

🚀 MCP Server for cli-kintone

This is an experimental repository aiming to explore the possibility of transforming cli-kintone into an MCP (Model Context Protocol) server.

🚀 Quick Start

This project is an experimental exploration to turn cli-kintone into an MCP server. It provides basic functions for interacting with kintone applications.

✨ Features

Currently, the following features are supported:

• Get Records: Retrieve records from kintone applications.

📦 Installation

# Clone the repository
git clone https://github.com/r3-yamauchi/mcp-server-cli-kintone-experimental.git
cd mcp-server-cli-kintone-experimental

# Install dependencies
npm install

# Build
npm run clean:lib && npm run build:mcp

💻 Usage Examples

[Basic Usage]

1. Creation of MCP Configuration File

Authenticate with username and password:

{
  "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"
      }
    }
  }
}

Authenticate with API token:

{
  "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. Limitations on API Tokens

In kintone API requests, a maximum of 9 API tokens can be specified per request. Specifying more than 10 will result in an error. This MCP Server supports a maximum of 9 comma-separated API tokens. Please note that an error will be reported if more than 10 API tokens are specified.

KINTONE_API_TOKEN="token1,token2,token3,token4,token5,token6,token7,token8,token9"

3. Placement of MCP Configuration File

• Claude Desktop App: ~/Library/Application Support/Claude/claude_desktop_config.json
• Claude VSCode Extension: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

4. Usage of AI Assistant

The AI assistant can call this tool in the following ways:

use_mcp_tool({
  server_name: "kintonecli",
  tool_name: "get_records",
  arguments: {
    app: "アプリID",
    query: "作成日時 > \"2025-01-01\"",
    fields: ["フィールド1", "フィールド2"]
  }
});

Or directly specify the domain and API token:

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"]
  }
});

📚 Documentation

Future Plans

• Create New Records: Create new records in kintone applications.
• Update Records: Update existing records in kintone applications.
• Delete Records: Delete records in kintone applications.
• Get App Information: Retrieve information about kintone applications.

📄 License

MIT License

Disclaimer

MCP, kintone, and related logos are registered trademarks of sap HEAVY industries.