NEI MCP Server

> Model Context Protocol (MCP) 服务器，让 AI 助手（Claude Desktop、Cursor 等）可以直接查询 NEI 接口定义。

功能

- get_interface: 获取单个接口的详细定义，包括请求/响应参数及关联数据类型
- list_interfaces: 列出项目中的所有接口，支持按 HTTP 方法和路径筛选
- get_datatypes: 获取项目中的数据类型定义

安装

$3

无需安装，直接配置 MCP 使用：

``json
{
"mcpServers": {
"nei": {
"command": "npx",
"args": ["-y", "nei-mcp-server"],
"env": {
"NEI_PRIVATE_TOKEN": "你的 NEI Private Token"
}
}
}
}
`

$3

`bash
npm install -g nei-mcp-server
`

配置

$3

1. 登录 NEI 平台
2. 进入个人设置 → API Token
3. 复制 Private Token

$3

支持以下方式配置 Token（按优先级排序）：

1. 命令行参数

`json
{
"mcpServers": {
"nei": {
"command": "npx",
"args": ["-y", "nei-mcp-server", "--token", "your-token-here"]
}
}
}
`

2. MCP 配置环境变量（推荐）

`json
{
"mcpServers": {
"nei": {
"command": "npx",
"args": ["-y", "nei-mcp-server"],
"env": {
"NEI_PRIVATE_TOKEN": "your-token-here"
}
}
}
}
`

3. 系统环境变量

`bash
export NEI_PRIVATE_TOKEN="your-token-here"
`

4. 本地 nei-ts-helper 配置文件（零配置）

如果你已经使用过 nei-ts-helper CLI 工具并保存过 Token，MCP Server 会自动读取 ~/.nei-ts-helper/config.json 中的配置，无需额外设置！

`json
// MCP 配置无需指定 Token
{
"mcpServers": {
"nei": {
"command": "npx",
"args": ["-y", "nei-mcp-server"]
}
}
}
`

在 AI 助手中使用

$3

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

`json
{
"mcpServers": {
"nei": {
"command": "npx",
"args": ["-y", "nei-mcp-server"],
"env": {
"NEI_PRIVATE_TOKEN": "your-token-here"
}
}
}
}
`

重启 Claude Desktop 后，你可以这样使用：

> 请帮我查看 NEI 接口 12345 的定义

$3

编辑 .cursor/mcp.json：

`json
{
"mcpServers": {
"nei": {
"command": "npx",
"args": ["-y", "nei-mcp-server"],
"env": {
"NEI_PRIVATE_TOKEN": "your-token-here"
}
}
}
}
`

工具说明

$3

获取单个接口的详细定义。

参数：
- interface_id (必填): NEI 接口 ID
- include_datatypes (可选): 是否包含关联的数据类型定义，默认 true

示例返回：
`markdown


接口: 获取用户信息

- ID: 12345
- 路径: /api/user/info
- 方法: GET
- 描述: 获取当前登录用户的信息

请求参数

无请求参数

响应参数

- id: Number (必填) - 用户 ID
- name: String (必填) - 用户名称
- avatar: String (可选) - 头像 URL
`

$3

列出项目中的所有接口。

参数：
- project_id (必填): NEI 项目 ID
- filter (可选): 筛选条件
- method: 按 HTTP 方法筛选（GET、POST 等）
- path_pattern: 按路径模式筛选

示例返回：
`markdown


项目接口列表 (共 15 个)

| ID | 方法 | 路径 | 名称 | 描述 |
|---|---|---|---|---|
| 12345 | GET | /api/user/info | 获取用户信息 | 获取当前登录用户的信息 |
| 12346 | POST | /api/user/update | 更新用户信息 | 更新用户基本信息 |
`

$3

获取项目中的数据类型定义。

参数：
- project_id (必填): NEI 项目 ID
- type_ids (可选): 指定要获取的数据类型 ID 列表

开发

`bash


安装依赖

pnpm install

开发模式

pnpm run dev

构建

pnpm run build

测试

pnpm run test
``

License

ISC