模型上下文协议服务器

一个为大型语言模型(如Claude)提供与NEXT结构化数据交互工具的MCP服务器,支持获取高亮和集群数据。

  • by Collaborne
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Collaborne/mcp-server

使用说明

下一个MCP服务器

提供交互工具的NEXT模型上下文协议(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
  1. 如果从源构建:
# Clone the repository
git clone https://github.com/Collaborne/mcp-server.git
cd mcp-server

# Install dependencies and build
npm install
npm run build
  1. 配置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检查器的调试

要使用MCP检查器调试服务器,您可以运行 sh run-inspector.sh

sh run-inspector.sh

连接到克劳德桌面

要将此服务器与Claude Desktop一起使用,请执行以下操作:

  1. 编辑您的Claude Desktop配置文件:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • 窗户: %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 使用下一个团队空间中的实际api密钥。访问NEXT API的范围是特定的团队空间。每个API令牌都绑定到一个团队空间,无法访问其外部的数据。

💣 如果克劳德桌面发生错误

如果您在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突出显示服务器有访问权限。这 工具仅限于一个团队空间

参数:

  • searchFilters (必填):根据用户查询筛选突出显示

示例输入:

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

输出示例:

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

接下来获取集群

列出服务器有权访问的可用NEXT群集。这 工具仅限于一个团队空间

参数:

  • searchQuery (必填):根据用户查询搜索集群

示例输入:

Summarize the main topics 

输出示例:

{
  "searchQuery": "main topics"
}

安全考虑

  • 服务器将仅访问团队空间特定的数据

与Claude一起使用

在桌面应用程序中与Claude交互时,您可以要求它执行以下NEXT操作:

  • “总结X主题的亮点”
  • “集群中提到的主要痛点是什么”

Claude将使用适当的MCP工具执行请求并向您展示结果。

许可证

麻省理工学院