# @gleanwork/mcp-config-glean 中文文档

规范地址：https://npmcn.com/package/%40gleanwork/mcp-config-glean/

版本：5\.4\.1
npm 元数据更新时间：2026-07-29T20:49:38.943Z
中文译文更新时间：2026-11-16T15:40:55.311Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40gleanwork/mcp-config-glean
原文对照：https://npmcn.com/package/%40gleanwork/mcp-config-glean/?lang=original
项目主页：https://github.com/gleanwork/mcp-config#readme
源码仓库：https://github.com/gleanwork/mcp-config

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：62.5 kB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：1 个
- 首次发布：2026-01-14T00:20:39.578Z
- 最新版本发布：2026-07-29T20:49:38.629Z
- 近 30 天下载量：41481（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：14（近 12 个月 14 个）

## 中文简介

Glean 特定 MCP 配置默认和帮助

## 安装

```sh
npm install @gleanwork/mcp-config-glean
```

也可以使用：`pnpm add @gleanwork/mcp-config-glean`、`yarn add @gleanwork/mcp-config-glean`、`bun add @gleanwork/mcp-config-glean`

## README

# @ gleanwork/ mcp- 配置- glean

Glean- specific MCP 配置默认和帮助. 环绕 `@gleanwork/mcp-config-schema` 具有 Glean 特定常数和方便功能.

## 安装

```bash
npm install @gleanwork/mcp-config-glean
```

## 使用量

### 快速启动

```typescript
import {
  createGleanRegistry,
  createGleanHeaders,
  buildGleanMcpUrl,
} from '@gleanwork/mcp-config-glean';

// Create a pre-configured registry (remote / HTTP only)
const registry = createGleanRegistry();
const builder = registry.createBuilder('cursor');

// Generate HTTP configuration
const httpConfig = builder.buildConfiguration({
  transport: 'http',
  serverUrl: buildGleanMcpUrl('https://my-company-be.glean.com'),
  headers: createGleanHeaders('my-api-token'),
});

// Pin the CLI version in generated install commands
const command = builder.buildCommand({
  transport: 'http',
  serverUrl: buildGleanMcpUrl('https://my-company-be.glean.com'),
  headers: createGleanHeaders('my-api-token'),
  cliVersion: '3.1.0',
});
// -> `npx -y @gleanwork/configure-mcp-server@3.1.0 remote --url ... --client cursor --token ...`
```

### 可用出口

#### 常数

```typescript
import { GLEAN_REGISTRY_OPTIONS, GLEAN_ENV } from '@gleanwork/mcp-config-glean';

// Registry options for Glean's remote MCP server (HTTP only)
GLEAN_REGISTRY_OPTIONS.tokenEnvVarName   // 'GLEAN_API_TOKEN'
GLEAN_REGISTRY_OPTIONS.commandBuilder    // Functions to generate CLI commands
GLEAN_REGISTRY_OPTIONS.serverNameBuilder // Callback that prefixes server names with glean_
GLEAN_REGISTRY_OPTIONS.managedSetupUrls  // Admin setup destinations for managed clients

// Environment variable names
GLEAN_ENV.SERVER_URL // 'GLEAN_SERVER_URL'
GLEAN_ENV.API_TOKEN  // 'GLEAN_API_TOKEN'
```

清册为ChatGPT提供管理下的设置目的地, 克劳德团队/企业和光标团队:

```typescript
const registry = createGleanRegistry();

registry.getManagedSetupUrl('chatgpt');
// https://chatgpt.com/admin/apps?tab=available&q=glean

registry.getManagedSetupUrl('claude-teams-enterprise');
// https://claude.ai/directory/connectors/glean

registry.getManagedSetupUrl('cursor-team');
// https://cursor.com/dashboard/integrations
```

#### 帮助函数

| 函数 | 说明 |
| --- | --- |
| `createGleanRegistry()` | 创建带有 Glean 默认的 MCPConfig Registry |
| `createGleanServerUrlEnv(serverUrl, apiToken?)` | 使用服务器 URL 创建 Env vars |
| `buildGleanMcpUrl(serverUrl, endpoint?)` | 从服务器 URL 构建完整的 MCP 端点 URL |
| `createGleanHeaders(apiToken)` | 创建授权页眉 |
| `normalizeGleanProductName(productName?)` | 规范白标签产品名称( 默认为“ glean ”) |
| `buildGleanServerName(options)` | 用 glean 前缀构建服务器名 |
| `normalizeGleanServerName(name, productName?)` | 将服务器名称规范化为带有前缀的安全配置密钥 |

#### 服务器名称函数

这些函数处理服务器名生成, 并带有适当的前缀 :

```typescript
import {
  normalizeGleanProductName,
  buildGleanServerName,
  normalizeGleanServerName,
} from '@gleanwork/mcp-config-glean';

// Normalize product names for white-labeling
normalizeGleanProductName();              // 'glean'
normalizeGleanProductName('Acme Corp');   // 'acme_corp'

// Build server names with glean_ prefix
buildGleanServerName({ transport: 'http' });                               // 'glean_default'
buildGleanServerName({ transport: 'http', serverUrl: '.../mcp/analytics' }); // 'glean_analytics'
buildGleanServerName({ serverName: 'custom' });                            // 'glean_custom'
buildGleanServerName({ agents: true });                                    // 'glean_agents'

// Normalize existing server names
normalizeGleanServerName('custom');        // 'glean_custom'
normalizeGleanServerName('glean_custom');  // 'glean_custom' (no double prefix)
```

#### 类型

```typescript
import type { GleanConnectionOptions, GleanEnvVars } from '@gleanwork/mcp-config-glean';

// GleanConnectionOptions extends MCPConnectionOptions with:
// - productName?: string  (for white-label support)
// - agents?: boolean      (use agents endpoint)
```

### 再出口

此软件包将全部从 `@gleanwork/mcp-config-schema`,这样您就可以从单个软件包中导入 Glean 特定类型和通用类型:

```typescript
import {
  // Glean-specific
  createGleanRegistry,
  createGleanServerUrlEnv,
  GLEAN_ENV,

  // From mcp-config-schema
  MCPConfigRegistry,
  type MCPConnectionOptions,
  type ClientId,
} from '@gleanwork/mcp-config-glean';
```

## 从 @gleanwork/ mcp- config 迁移

如果你是从长者迁徙过来 `@gleanwork/mcp-config` 软件包 :

1.  更新您的软件包。 json :
    
    ```diff
    - "@gleanwork/mcp-config": "^3.x"
    + "@gleanwork/mcp-config-glean": "^4.x"
    ```
    
2.  更新您的导入 :
    
    ```diff
    - import { ... } from '@gleanwork/mcp-config';
    + import { ... } from '@gleanwork/mcp-config-glean';
    ```
    

API是完全相容的 - 在导入路径之外不需要更改代码 .

## 相关软件包

-   **[@gleanwork/mcp-config-schema (英语)](https://www.npmjs.com/package/@gleanwork/mcp-config-schema)** - 有核心类型和建造商的供应商中立基包

## 许可证

麻省理工学院

## 常见问题

### @gleanwork/mcp-config-glean 是什么？

Glean 特定 MCP 配置默认和帮助

### 如何安装 @gleanwork/mcp-config-glean？

在项目目录运行 npm install @gleanwork/mcp-config-glean，或使用 pnpm add / yarn add / bun add。

### @gleanwork/mcp-config-glean 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @gleanwork/mcp-config-glean 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @gleanwork/mcp-config-glean 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @gleanwork/mcp-config-glean 可以商用吗？

@gleanwork/mcp-config-glean 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @gleanwork/mcp-config-glean 的下载量有多少？

根据 npm 官方下载统计，@gleanwork/mcp-config-glean 在 2026/10/17 – 2026/11/15 这 30 天内被下载 41,481 次，日均约 1,383 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @gleanwork/mcp-config-glean 还在维护吗？

最新版本 5\.4\.1 发布于 2026/07/30（3 个月前）；至今共发布 14 个版本，其中过去 12 个月发布了 14 个；首次发布于 2026/01/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

