Wrhs Next MCP

MCP数据服务

提供方 sgore-godaddy

数据服务 未标注 无需鉴权 社区 / 第三方 Claude DesktopClaudeCursor

一个将Warehouse.ai API端点暴露为工具供AI助手(如Cursor)使用的MCP(模型上下文协议)服务器。

一句话选型结论

按资料字段整理

Wrhs Next MCP 属于数据服务类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude Desktop、Claude、Cursor,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 5 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量5暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

AI助手工具TypeScript本地部署API集成版本管理环境部署数据查询

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 5 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 5 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Wrhs Next MCP当前 5 未标注 未标注 无 2026-05-17
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方sgore-godaddy上游标注的维护方 sgore-godaddy
分类数据服务本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.7 KB
来自项目仓库与上游目录的原文,未做删改

Warehouse.ai MCP 服务器

一个MCP(模型上下文协议)服务器,它将Warehouse.ai API端点作为工具暴露出来,供像Cursor这样的AI助手使用。

什么是MCP?

MCP(模型上下文协议)允许AI助手通过标准化工具与外部系统进行交互。此服务器使您的Warehouse.ai API对AI助手可用,从而使它们能够代表您获取数据。

快速启动

设置

遵循 安装 按照以下说明在Cursor中配置MCP服务器。

使用示例

安装后,您可以向Cursor中的AI助手提出问题,例如:

检查不同环境中的版本:

  • “生产环境中@ux/application-sidebar的仓库版本是什么?”
  • “测试环境中使用的是哪个版本的无页眉(no-header)?”
  • “比较开发环境与生产环境中utility-header的版本”
  • “在 wrhs 中,哪个版本的 application-sidebar 是最新的?”(自动查找 @ux/application-sidebar)

查找可用版本:

  • “@ux/application-sidebar 有哪些可用版本?”
  • “显示所有无标题版本”
  • “列出 @ux/application-sidebar 的版本历史”

查找软件包的部署位置:

  • “@ux/application-sidebar 部署在哪里?”
  • “哪些环境中使用了无头包(或无标题包)?”
  • “@ux/button 是否已投入生产?”

获取详细信息:

  • “列出 wrhs 生产环境中 @ux/application-sidebar 模块在 _default 变体下的所有文件”
  • “请比较并告诉我,在测试环境中,wrhs 项目中 @ux/application-sidebar 目录下的 application-sidebar.css 文件在 7.2.0 版本和 7.0.0 版本之间的差异。”
  • “在生产环境中显示@ux/application-sidebar的环境详情”
  • “获取测试中无标题的配置”

特点/特性

  • 📦 箱子/包裹 查询软件包版本 - 检查在开发、测试或生产环境中部署了哪些版本
  • 🌍 表示地球或全球。 探索环境 - 查找软件包的部署位置
  • 📊(图表) 获取环境详情 - 查看特定环境的配置
  • 🎯(瞄准目标) 智能包裹查询 - 自动重试 @ux/ 如果未找到包,则添加前缀(例如,“application-sidebar” → “@ux/application-sidebar”)

安装

  1. 克隆仓库:```bash
    git clone https://github.com/your-org/wrhs-next-mcp.git
    cd wrhs-next-mcp

1. **安装依赖项:**```bash
npm install
  1. 构建项目:```bash
    npm run build

1. **配置光标:**

在您的Cursor MCP设置中添加以下内容:**设置... → 光标设置 → 工具与MCP(主控面板/多点触控面板,具体含义根据上下文确定)**):```json
{
"mcpServers": {
"wrhs-next-api": {
"command": "node",
"args": ["/absolute/path/to/wrhs-next-mcp/dist/index.js"],
"env": {
"WRHS_NEXT_ENDPOINT": "https://your-warehouse-api.com",
"WRHS_NEXT_USERNAME": "your-username",
"WRHS_NEXT_PASSWORD": "your-password"
}
}
}
}

重要提示: 替换 /absolute/path/to/wrhs-next-mcp 以及你克隆仓库的实际路径。

  1. 重启光标 加载MCP服务器。

为Claude桌面添加MCP服务器

要使用此MCP服务器与Claude Desktop配合,请按照以下步骤操作:

  1. 打开Claude桌面版 并且前往 设置.

  2. 导航至 开发者 表(或表格)。

  3. 点击 编辑配置 按钮。这将在Finder中打开包含配置文件的文件夹。

  4. 打开配置文件(通常 claude_desktop_config.json并添加MCP服务器配置:```json
    {
    "mcpServers": {
    "wrhs-next-api": {
    "command": "node",
    "args": ["/absolute/path/to/wrhs-next-mcp/dist/index.js"],
    "env": {
    "WRHS_NEXT_ENDPOINT": "https://your-warehouse-api.com",
    "WRHS_NEXT_USERNAME": "your-username",
    "WRHS_NEXT_PASSWORD": "your-password"
    }
    }
    }
    }


1. **保存** 配置文件。

**注:**

- 替换 `/absolute/path/to/wrhs-next-mcp` 使用你克隆仓库的实际路径。
- 请使用您实际的仓库API终端和凭据。

6. **重启Claude桌面版** 加载新的MCP服务器配置。

### 更新至最新版本```bash
cd wrhs-next-mcp
git pull
npm install
npm run build
# Restart Cursor

可用工具

get_object

从仓库API中获取对象数据。

参数:

  • name (字符串,必填):要检索的对象的名称
  • env (字符串,必填):环境(例如,开发、预生产、生产)
  • acceptedVariants (数组,可选):接受的变体数组(例如,['en-US', 'en-GB'])
  • version (字符串,可选):对象的特定版本(例如,'1.0.0')

get_head

获取特定名称和环境下的头部信息(不下载完整对象的元数据)。

参数:

  • name (字符串,必填):对象的名称
  • env (字符串,必填):环境(例如,开发、预生产、生产)

list_versions

列出特定软件包的所有可用版本。

参数:

  • name (字符串,必填):包的名称(例如,“@ux/application-sidebar”)

list_environments

列出所有已部署特定包的环境。

参数:

  • name (字符串,必填):包的名称(例如,“@ux/application-sidebar”)

get_environment_details

获取特定环境中软件包的详细信息,包括元数据和配置。

参数:

  • name (字符串,必填):包的名称(例如,“@ux/application-sidebar”)
  • env (字符串,必填):环境(例如,开发、预生产、生产)

发展

先决条件

  • Node.js 24及以上版本
  • npm(Node Package Manager,节点包管理器)
  • 访问Warehouse.ai API

本地开发环境设置

  1. 克隆并安装依赖项(见上文)

  2. 创建环境文件:```bash
    cp .env.example .env


编辑 `.env` 并添加您的凭据:```
WRHS_NEXT_ENDPOINT=https://your-warehouse-api.com
WRHS_NEXT_USERNAME=your-username
WRHS_NEXT_PASSWORD=your-password
  1. 在开发模式下运行:```bash
    npm run dev

### 建筑```bash
npm run build

这个将TypeScript编译成JavaScript在 dist/ 目录。

测试

方法1:在光标处测试

  1. 确保服务器已在Cursor中进行配置(参见安装指南)
  2. 重启光标
  3. 检查MCP连接状态 设置... → 光标设置 → 工具与MCP(手动控制面板/多点触控面板,具体含义根据上下文确定)
  4. 通过询问Cursor进行测试:
    - "使用 wrhs-api 获取名为 'test' 的对象"
    - “在‘生产’环境中获取‘myapp’的头部信息”

方法2:MCP Inspector(开发推荐)

全局安装 MCP Inspector:```bash
npm install -g @modelcontextprotocol/inspector


运行检查器:```bash
mcp-inspector node dist/index.js

这会打开一个网页用户界面,在其中你可以:

  • 查看所有可用工具
  • 使用不同参数调用测试工具
  • 实时查看回复

方法3:基于日志的调试

添加 console.error() (文件、报告等中的)陈述 src/index.ts 用于调试。这些日志会出现在 Cursor 的 MCP 日志中。

单元测试与代码质量

快捷命令:```bash
npm test # Run unit tests
npm run test:coverage # Run with coverage
npm run lint # Check code quality
npm run validate # Run all checks


## 项目结构```
wrhs-next-mcp/
├── src/
│   └── index.ts          # Main MCP server implementation
├── dist/                 # Compiled JavaScript (generated)
├── package.json          # Dependencies and scripts
├── .env.example          # Environment variable template
├── .gitignore           # Git ignore rules
└── README.md            # This file

它是如何运作的

  1. 服务器生命周期MCP服务器作为由Cursor启动的子进程运行。它
  • 在Cursor打开时启动
  • 在光标运行时保持存活
  • 当光标关闭时终止
  1. 交流使用stdio(标准输入/输出)与Cursor进行通信

  2. 认证凭据通过 Cursor 配置中的环境变量传递

  3. API客户端使用现有的 warehouse.ai-api-client npm包,用于与仓库API进行交互

故障排除

“服务器未找到”错误

  • 原因游标配置中的路径错误
  • 修复使用绝对路径(运行 pwd (在项目目录中)并确保它指向 dist/index.js

“身份验证错误”

  • 原因无效的凭据
  • 修复验证 WRHS_NEXT_USERNAME 并且 WRHS_NEXT_PASSWORD 在Cursor MCP配置中

“没有工具显示”

  • 原因构建失败或服务器崩溃
  • 修复:
    1. 跑 npm run build 并检查错误
    1. 检查 Cursor 的 MCP 日志设置... → 光标设置 → 工具与MCP)

“更改未显示”

  • 原因服务器未重新加载
  • 修复代码更改后,运行 npm run build 然后重启 Cursor

失踪 warehouse.ai-api-client 包(或包裹)

  • 原因软件包未安装或无法访问
  • 修复确保该包在您的npm注册表中可用,或者从您的内部源进行安装

安全注意事项

⚠️ 永远不要将凭据提交到版本控制系统中!

  • 真实的凭证应该仅存在于:
  • 本地 .env 文件(已忽略在Git中)
  • 每个团队成员的独立光标MCP配置
  • 这个(或“该”) .env.example 文件中应仅包含占位符
  • 每个团队成员使用自己的凭据

未来改进

  • [ ] 添加写操作(POST、PUT、DELETE)
  • [ ] 响应缓存以提高性能
  • [ ] 为AI提供更好的错误信息
  • [ ] 用于调试的请求/响应日志记录
  • 支持额外的API端点
  • [ ] 限流和重试逻辑

做出贡献

  1. 做出改变于 src/
  2. 构建: npm run build
  3. 使用MCP检查器或光标进行测试
  4. 提交拉取请求

许可证

ISC(国际空间站)

支持

对于问题或疑问:

  • 检查一下 故障排除 部分;章节
  • 在Cursor设置中查看MCP日志

资源:

  • MCP 文档
  • MCP SDK GitHub(可译为:“MCP SDK 在 GitHub 上”或“MCP SDK 的 GitHub 仓库”)

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Wrhs Next MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Wrhs Next MCP 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Wrhs Next MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Wrhs Next MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Wrhs Next MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Wrhs Next MCP 能提供哪些能力?

资料显示约 5 个工具;能力标签包括 版本管理、TypeScript、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。