mcp-installer

MCP 安装器

查找、安装并配置适用于 OpenCode 的 MCP 服务。

1. 搜索 MCP 服务

先检查本地目录（快速查看是否已有文档记录的 MCP）：

python3 ~/.config/opencode/skill/mcp-installer/scripts/list_mcps.py

如果本地未找到，请在线搜索：

• websearch("MCP server for [capability]")
• webfetch("https://github.com/modelcontextprotocol/servers")
• 检查 npm：@modelcontextprotocol/server-*
• 检查 MCP 规范仓库：https://github.com/modelcontextprotocol

2. 阅读 MCP 详情

对于相关匹配项，请阅读完整的 MCP 文件：

references/mcps/<name>.md

其中包含安装配置、设置步骤、功能和链接。

3. 配置

将 MCP 配置添加到用户的 opencode.json 中。

4. 记录新的 MCP

如果你在线发现了新的 MCP 服务，必须使用下面的模板将其记录到 references/mcps/<name>.md，以供日后参考。

5. 设置（如有需要）

• OAuth：运行 opencode mcp auth <server-name>
• API 密钥：设置环境变量
• 其他：按照 MCP 专属设置步骤操作

<question_tool>

批量提问： 有 2 个或更多相关问题时，使用 question 工具。单个问题 → 直接使用纯文本。

语法： header 不超过 12 个字符，label 为 1-5 个词，并为默认选项添加“(Recommended)”。

适用情况：有多个 MCP 符合需求，或设置需要 OAuth/API 密钥时。

</question_tool>

本地 MCP

{
  "mcp": {
    "name": {
      "type": "local",
      "command": ["npx", "-y", "@package/name"]
    }
  }
}

远程 MCP

{
  "mcp": {
    "name": {
      "type": "remote",
      "url": "https://example.com/mcp"
    }
  }
}

MCP 工具管理

MCP 会公开工具。通过 permission 部分使用工具名称进行控制（通常是 MCP 名称）：

全局/Agent 权限：

{
  "permission": {
    "my-mcp": "deny",          // Disable all tools for this MCP
    "my-mcp*": "deny"          // Wildcard support
  }
}

基于模式的控制：

{
  "permission": {
    "my-mcp": {
      "safe_tool": "allow",
      "risky_tool": "ask",
      "*": "deny"
    }
  }
}

旧版配置

Agent 有时可能会处理使用过时配置字段（例如 tools:）的旧版项目。遇到这种情况时，必须将其更正为现代的 permission: 系统。

OAuth

使用 OAuth 的远程 MCP 会自动进行身份验证：

opencode mcp auth <server-name>

查看状态：opencode mcp list

<reference_files>

你需要……	阅读此文件
所有配置选项（本地、远程、oauth、环境变量）	references/configuration.md
常见 MCP 服务示例	references/examples.md
故障排查	references/troubleshooting.md

注意： 本地目录（list_mcps.py）是已发现 MCP 的缓存，并非完整列表。如果在本地找不到匹配项，应该始终在线搜索。

</reference_files>

<documenting_new_mcps>

发现新的 MCP 服务时，必须将其记录下来：

位置： references/mcps/<name>.md

模板：

---
name: mcp-name
url: https://github.com/org/repo
type: local|remote
auth: oauth|api-key|none
description: One-line description
tags: [tag1, tag2]
---
# Display Name

Brief description.

## Installation

\`\`\`jsonc
{
  "mcp": {
    "name": {
      "type": "remote",
      "url": "https://example.com/mcp"
    }
  }
}
\`\`\`

## Setup

Steps for auth, env vars, etc.

## Features

- Feature 1
- Feature 2

## Links

- [GitHub](url)

然后运行：python3 scripts/list_mcps.py 进行验证。

Frontmatter 字段

字段	必填	用途
name	是	MCP 标识符（配置中的键）
url	否	来源 URL
type	是	local 或 remote
auth	是	oauth、api-key 或 none
description	是	用于目录的一句话描述
tags	否	类别标签数组

</documenting_new_mcps>