Next MCP server

Next MCP サーバー

NEXT データとやり取りするためのツールを提供する NEXT Model Context Protocol（MCP）サーバーです。

概要

この MCP サーバーを使用すると、Claude などの大規模言語モデル（LLM）が NEXT の構造化データとやり取りできます。次のツールを提供します。

• ハイライトの取得
• クラスターの取得

このサーバーは TypeScript と MCP SDK を使用して構築されており、LLM が NEXT とやり取りするための安全で標準化された方法を提供します。

インストール

前提条件

• Node.js 18 以降
• npm
• NEXT API キー

セットアップ

1. npm 経由でインストールします。

# Install globally via npm
npm install -g @collaborne/mcp-server

# Or as a dependency in your project
npm install @collaborne/mcp-server

2. ソースからビルドする場合：

# Clone the repository
git clone https://github.com/Collaborne/mcp-server.git
cd mcp-server

# Install dependencies and build
npm install
npm run build

3. NEXT へのアクセスを設定します。

AWS の設定を記述した .env ファイルを作成します。

API_KEY=your-api-key

または、これらを環境変数として設定します。

設定

次の環境変数を使用してサーバーを設定できます。

変数	説明	デフォルト
API_KEY	設定から生成できる NEXT API キー	``

サーバーの実行

Node.js を使用してサーバーを実行できます。

# Using npx (without installing)
npx @collaborne/mcp-server

# If installed globally
npm install -g @collaborne/mcp-server
cd mcp-server

# If running from cloned repository
npm start

# Or directly
node dist/index.js

MCP Inspector でのデバッグ

MCP Inspector を使用してサーバーをデバッグするには、sh run-inspector.sh を実行します。

sh run-inspector.sh

Claude Desktop への接続

このサーバーを Claude Desktop で使用するには：

1. Claude Desktop の設定ファイルを編集します。

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. NEXT MCP サーバーを設定に追加します。

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": ["@collaborne/mcp-server"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

重要：上記の設定を使用する際は、次の点に注意してください。

• NEXT_API_KEY を next チームスペースの実際の API キーに置き換えてください。NEXT API へのアクセス範囲は特定のチームスペースに限定されます。各 API トークンは 1 つのチームスペースに紐付けられており、その範囲外のデータにはアクセスできません。

💣 Claude Desktop でエラーが発生する場合

Claude Desktop で上記の設定を使用してエラーが発生する場合は、次のように絶対パスを使用してみてください。

# Get the path of node and mcp-server
which node
which @collaborne/mcp-server

{
  "globalShortcut": "",
  "mcpServers": {
    "next": {
      "command": "your-absolute-path-to-node",
      "args": ["your-absolute-path-to-mcp-server/dist/index.js"],
      "env": {
        "API_KEY": "your-api-key",
      }
    }
  }
}

利用可能なツール

next-get-highlights

サーバーがアクセスを許可されている NEXT のハイライトを一覧表示します。このツールは 1 つのチームスペースに限定されます。

パラメーター：

• searchFilters（必須）：ユーザーのクエリに基づくハイライトのフィルター

入力例：

What are the user frustrations and issues mentioned in the last week 

出力例：

{
  "searchFilters": {
    "dateFilter": "last week",
    "typeFilters": [
      "Pain Point"
    ]
  }
}

next-get-clusters

サーバーがアクセスを許可されている NEXT のクラスターを一覧表示します。このツールは 1 つのチームスペースに限定されます。

パラメーター：

• searchQuery（必須）：ユーザーのクエリに基づくクラスターの検索クエリ

入力例：

Summarize the main topics 

出力例：

{
  "searchQuery": "main topics"
}

セキュリティに関する考慮事項

• サーバーはチームスペース固有のデータのみを利用します。

Claude での使用方法

デスクトップアプリで Claude とやり取りする際、次のような NEXT の操作を依頼できます。

• 「X のトピックに関するハイライトを要約して」
• 「クラスターで言及されている主な課題は何ですか」

Claude は適切な MCP ツールを使用してリクエストを実行し、結果を表示します。

ライセンス

MIT