MCP 服务器

hipmmcode 是完整的 Model Context Protocol 客户端:stdio、HTTP、SSE 三种传输,OAuth 2.0 登录,标准 .mcp.json,以及针对项目自带服务器的信任门。每个已连接服务器的工具以 mcp__<server>__<tool> 呈现给模型;资源经 ListMcpResources / ReadMcpResource 访问。

添加服务器

# stdio —— `--` 之后是子进程命令
hipmmcode mcp add fs -- npx -y @modelcontextprotocol/server-filesystem /tmp

# HTTP
hipmmcode mcp add --transport http notion https://mcp.notion.com/mcp

# 带认证头的 HTTP
hipmmcode mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer <PAT>"

# 原始 JSON(与 .mcp.json 条目同构)
hipmmcode mcp add-json weather '{"type":"http","url":"https://…"}'

# 打包好的 .mcpb bundle
hipmmcode mcp add-mcpb ./server.mcpb

常用 flag:-e KEY=VALUE(stdio 环境)、-H "Header: V"(可重复)、--transport stdio|http|sse(省略时按 URL 推断)、--client-id / --callback-port(OAuth)。

作用域

作用域	存哪	可见性
local(默认)	你的配置,绑定本项目	只有你、只在这里
project	仓库里的 .mcp.json	全仓库协作者 —— 需要批准(见下)
user	你的配置	你的所有项目

hipmmcode mcp add -s project … 写标准 .mcp.json,整个团队共享服务器定义。

管理

hipmmcode mcp list             # 跨作用域合并视图,标注 [project, pending approval]
hipmmcode mcp get <name>       # 解析后的配置,密钥打码
hipmmcode mcp remove <name>    # 作用域自动探测,或 -s 指定
hipmmcode mcp login <name>     # 受保护服务器的浏览器 OAuth(--force 重新认证)
hipmmcode mcp reset-project-choices [--all]

REPL 里 /mcp 打开交互面板:↑/↓ 选择 → 查看工具 / 重连 / 启用 / 停用 / 批准 / 拒绝:

hipmmcode

› /mcp

MCP servers  已配置 3 个 · 1 个待批准
❯ notion   http · 已连接 · 12 个工具
  fs       stdio · 已连接 · 8 个工具
  corp     sse · [project, pending approval]

Enter 查看工具 · r 重连 · d 停用 · a 批准 · x 拒绝

信任门

经项目 .mcp.json 到来的服务器保持 pending 状态,直到你批准(/mcp approve 或面板)—— 入库的配置不能悄悄获得工具权限。决定按项目持久;mcp reset-project-choices 重置。

智能体自助配置

智能体可经 McpConfig 工具自己管理 MCP —— *"接一下 Notion MCP 服务器"*直接可用,写的就是标准 .mcp.json。变更操作过权限引擎(默认模式弹窗,无人值守失败关闭)。

服务器配置形状

.mcp.json / mcpServers 条目:

{
  "mcpServers": {
    "fs":     { "type": "stdio", "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"], "env": {} },
    "notion": { "type": "http",  "url": "https://mcp.notion.com/mcp", "headers": {} },
    "corp":   { "type": "sse",   "url": "https://mcp.corp.dev/sse",
                "headersHelper": "vault read -field=hdrs secret/mcp",
                "oauth": { "clientId": "…", "callbackPort": 8080, "scopes": "read write" },
                "timeout": 30000, "alwaysLoad": true }
  }
}

值支持 ${VAR} 环境展开;headersHelper 运行一条输出 JSON 头的 shell 命令(短期 token)。

外部同步与 CLI 覆盖

• mcpSyncFromClaude(默认开)自动导入 .claude 生态里已配置的 MCP 服务器,现有配置立刻可用。hipmmcode mcp sync off 关闭;裸 hipmmcode mcp sync 则一次性拷贝进 user 作用域。
• --mcp-config <file|json>(可重复)为单次运行加载额外服务器;--strict-mcp-config 只用这些,忽略 project/user/插件/IDE 来源。