Next MCP server

Next MCP 服务

一个 NEXT Model Context Protocol（MCP）服务，提供用于与 NEXT 数据交互的工具。

概览

此 MCP 服务允许 Claude 等大模型与 NEXT 结构化数据交互。它提供以下工具：

• 获取精选内容
• 获取聚类

该服务使用 TypeScript 和 MCP SDK 构建，为大模型与 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 访问权限：

创建一个 .env 文件并填写 AWS 配置：

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 team-space 的实际 API 密钥。NEXT API 的访问权限限定于特定的 team-space。每个 API 令牌都绑定到一个 team-space，无法访问其范围之外的数据。

💣 如果 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 精选内容。此工具仅限于一个 team-space

参数：

• searchFilters（必需）：根据用户查询筛选精选内容

输入示例：

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

输出示例：

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

next-get-clusters

列出此服务有权访问的 NEXT 聚类。此工具仅限于一个 team-space

参数：

• searchQuery（必需）：根据用户查询搜索聚类

输入示例：

Summarize the main topics 

输出示例：

{
  "searchQuery": "main topics"
}

安全注意事项

• 服务只会访问特定 team-space 的数据

与 Claude 一起使用

在桌面应用中与 Claude 交互时，可以要求它执行 NEXT 操作，例如：

• “总结关于 X 主题的精选内容”
• “聚类中提到的主要痛点有哪些？”

Claude 将使用相应的 MCP 工具执行请求，并向你展示结果。

许可证

MIT