Skip to main content
Glama
yamatairiku-dev

Kintone Book Management MCP Tool

README.md
# Kintone 書籍管理 MCP アプリケーション

このプロジェクトは、Model Context Protocol (MCP) を介してツールを公開する Kintone 書籍管理アプリケーションです。

## セットアップ

プロジェクトをセットアップするには、以下の手順に従ってください。

1.  **リポジトリのクローン:**

    ```bash
    git clone <repository-url>
    cd kintone-bookmanage-mcp
    ```

2.  **依存関係のインストール:**

    ```bash
    npm install
    ```

3.  **環境変数の設定:**

    プロジェクトのルートディレクトリに `.env` ファイルを作成し、以下の変数を設定します。

    ```
    KINTONE_BASE_URL=YOUR_KINTONE_BASE_URL
    KINTONE_API_TOKEN=YOUR_KINTONE_API_TOKEN
    KINTONE_APP_ID=YOUR_KINTONE_APP_ID
    KINTONE_REQUEST_FIELDS=YOUR_KINTONE_REQUEST_FIELDS
    ```

    プレースホルダーの値を実際の Kintone 環境の詳細に置き換えてください。

## アプリケーションの実行

アプリケーションを実行するには、まずビルドしてからサーバーを起動する必要があります。

1.  **プロジェクトのビルド:**

    ```bash
    npm run build
    ```

2.  **サーバーの起動:**

    ```bash
    node build/index.js
    ```

    サーバーが起動し、MCP ツールが公開されます。

## 使用方法

このアプリケーションは `get-book-information` という名前のツールを公開しており、`mcp-cli` (グローバルにインストールされている場合) を使用するか、`build/index.js` と直接やり取りすることで呼び出すことができます。

`get-book-information` ツールを呼び出すには (`mcp-cli` が利用可能で設定されていると仮定します):

```bash
mcp-cli call get-book-information
```

これにより、Kintone アプリケーションから書籍レコードがフェッチされ、フォーマットされた情報が返されます。

## Claude Desktopの設定例
```
{
  "mcpServers": {
    "books": {
      "command": "node",
      "args": ["/Users/tairiku/dev/kintone-bookmanage-mcp-stdin/build/index.js"]
    }
	}
}
```

TDQS

B3/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of ambiguity or overlap between tools. The single tool has a clear, distinct purpose of retrieving book information.

Naming Consistency5/5

Since there is only one tool, naming consistency is inherently perfect. The tool name follows a clear verb_noun pattern (get-book-information), which is appropriate and consistent within this minimal set.

Tool Count2/5

A single tool for a book management system is too few for the apparent scope, as it only supports retrieval without create, update, delete, or other management operations. This severely limits functionality and indicates an incomplete tool surface.

Completeness1/5

The tool set is severely incomplete for a book management domain. It only provides a get operation, lacking essential CRUD operations like create, update, and delete, as well as other expected features such as searching or listing books, which will cause agent failures in typical management workflows.

Maintenance

ActivityInactive
ResponsivenessNo issues