preset url

为预设生成客户端 URL。

有关预设管理的完整概述，请参阅 预设命令概述。

概要

npx -y @1mcp/agent preset url <name>

参数

• <name>
  • 要为其生成 URL 的预设名称。
  • 必需：是

描述

preset url 命令为特定预设生成客户端 URL。此 URL 可以直接在 MCP 客户端配置中使用，以访问由预设定义的过滤服务器子集。

URL 格式

http://host:port/mcp?preset=name

• host:port：您的 1MCP 服务器地址（默认：127.0.0.1:3050）
• preset=name：激活预设的查询参数

示例

基本用法

# 为开发预设生成 URL
npx -y @1mcp/agent preset url development
# Output: http://127.0.0.1:3050/mcp?preset=development

# 为生产预设生成 URL
npx -y @1mcp/agent preset url production
# Output: http://127.0.0.1:3050/mcp?preset=production

与客户端配置的集成

Claude Desktop

使用 stdio 代理将 Claude Desktop 连接到正在运行的 1MCP HTTP 服务器，并应用预设：

{
  "mcpServers": {
    "1mcp-development": {
      "command": "npx",
      "args": ["-y", "@1mcp/agent", "proxy", "--preset", "development"]
    }
  }
}

Cursor/VS Code

{
  "mcp.servers": {
    "1mcp-production": {
      "url": "http://127.0.0.1:3050/mcp?preset=production"
    }
  }
}

用例

开发环境设置

# 获取开发预设 URL
DEV_URL=$(npx -y @1mcp/agent preset url development)
echo "Configure your development client with: $DEV_URL"

团队配置共享

# 与团队成员共享预设 URL
echo "Development: $(npx -y @1mcp/agent preset url team-dev)"
echo "Staging: $(npx -y @1mcp/agent preset url team-staging)"
echo "Production: $(npx -y @1mcp/agent preset url team-prod)"

自动化脚本

#!/bin/bash
# 使用当前预设 URL 更新客户端配置

DEV_URL=$(npx -y @1mcp/agent preset url development)
PROD_URL=$(npx -y @1mcp/agent preset url production)

# 更新配置文件
sed -i "s|preset=development|${DEV_URL}|g" config/dev.json
sed -i "s|preset=production|${PROD_URL}|g" config/prod.json

动态服务器选择

当客户端使用预设 URL 时：

1. 请求处理：1MCP 服务器接收带有 ?preset=name 的请求
2. 预设解析：服务器查找预设配置
3. 服务器过滤：将预设的标签查询应用于可用服务器
4. 动态响应：仅将匹配的服务器返回给客户端
5. 未知预设：返回 HTTP 400；绝不会回退到未过滤的服务器列表

上下文切换

客户端可以通过更改预设参数切换服务器上下文：

# 开发上下文
http://127.0.0.1:3050/mcp?preset=development

# 生产上下文
http://127.0.0.1:3050/mcp?preset=production

# 所有服务器（无过滤）
http://127.0.0.1:3050/mcp

错误处理

预设未找到

npx -y @1mcp/agent preset url nonexistent
# Error: Preset 'nonexistent' not found

服务器配置问题

如果服务器配置有问题，URL 仍然生成，但可能无法按预期工作。使用 preset test <name> 验证服务器匹配。

URL 验证

生成的 URL 经过验证以确保：

• 预设存在：命名的预设在您的配置中
• 有效格式：URL 遵循正确的 HTTP 格式
• 服务器可访问性：基于当前服务器配置

工作流程集成

常见用法模式：

# 1. 创建或验证预设存在
npx -y @1mcp/agent preset list

# 2. 为客户端配置生成 URL
npx -y @1mcp/agent preset url development

# 3. 测试预设以验证服务器匹配
npx -y @1mcp/agent preset test development

# 4. 使用生成的 URL 配置您的 MCP 客户端

高级用法

自定义服务器配置

如果您的 1MCP 服务器在不同的主机/端口上运行：

# URL 将反映您服务器的实际配置
# 例如，如果在端口 3052 上运行：
npx -y @1mcp/agent preset url development
# Output: http://127.0.0.1:3052/mcp?preset=development

多环境

# 为不同环境生成 URL
for env in development staging production; do
  echo "$env: $(npx -y @1mcp/agent preset url $env)"
done

另请参阅

• preset show - 显示完整的预设详细信息，包括 URL
• preset test - 测试预设服务器匹配
• preset create - 创建新预设以生成 URL
• preset list - 列出所有可用的预设