快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

详细介绍

mmcp的MCP服务器管理示例

颗粒增强金属基复合材料是集中管理Model Context Protocol（MCP）服务器的设置，适用于多个AI代理（Claude Code、Cursor等）的工具。

📋 概要

主要功能

将MCP服务器~/.mmcp.json集中管理
批量应用于多个代理（Claude Code、Claude Desktop、GitHub Copilot CLI、Gemini CLI等）
使用环境变量进行安全API key管理
使用一个命令将设置同步到所有代理

关于此存储库

此存储库包含使用mmcp管理MCP服务器的示例设置：

mmcp单体的使用方法 -基本用法（此自述文件）
通过mise实现自动化 -更高级的自动化（docs/MISE.md）
CLI工具vs MCP服务器 - gh啊gcloud等有效区分CLI工具和MCP服务器的方法（docs/CLI_VS_MCP.md）
API key取得方法 -每个服务的令牌获取过程（docs/API_KEYS.md文件）
故障排除 -问题解决指南（docs/TROUBLESHOOTING.md）

______________________________________________________________________

🚀 快速启动

1. 前提条件

必须安装Node.js。

# Node.js のインストール確認
node --version

# 未インストールの場合（macOS）
brew install node

# または公式サイトからダウンロード
# https://nodejs.org/

2.安装mmcp

# npm でインストール
npm install -g mmcp@0.6.2

# バージョン確認（v0.6.0 以上が必要）
mmcp --version

备注：v0.6.0或更高版本 --mode replace 已添加选项。旧版本可能无法正确反映MCP服务器的删除。

3.添加MCP服务器

首先从不需要环境变量的MCP服务器开始吧。

# Filesystem - ファイル操作（デスクトップへのアクセスを許可）
mmcp add filesystem npx -y @modelcontextprotocol/server-filesystem /Users/$(whoami)/Desktop

# Playwright - ブラウザ自動化
mmcp add playwright npx -y @playwright/mcp

# Draw.io - ダイアグラム生成（Mermaid/CSV/XML → draw.ioエディタで表示）
mmcp add drawio npx -y @drawio/mcp

4.注册代理

注册要使用的AI代理。

# VS Code拡張のClaude Codeを使う場合
mmcp agents add claude-code

# 他のエージェントも使う場合（オプション）
mmcp agents add claude-desktop     # Claude Desktopアプリ
mmcp agents add github-copilot-cli # GitHub Copilot CLI
mmcp agents add gemini-cli         # Google Gemini CLI

5.应用设置

mmcp apply

6.重新启动VS代码

重新启动VSCode后，可以使用Claude Code扩展功能的MCP服务器！

Command Palette (Cmd+Shift+P) > Developer: Reload Window

______________________________________________________________________

🔑 需要环境变量的MCP服务器

如果使用MCP服务器（如Notion），则必须设置API key/令牌。

获取标记

详细的取得方法是 docs/API_KEYS.md文件来修改标记元素的显示属性。

概念：集成Token（写入、只读两种）
双子座：API密钥
谷歌云：应用程序默认身份证明或服务帐户密钥

设置环境变量

# 一時的に設定
export NOTION_TOKEN=ntn_xxxxx

# 永続化する場合は ~/.zshrc や ~/.bashrc に追加
echo 'export NOTION_TOKEN=ntn_xxxxx' >> ~/.zshrc
source ~/.zshrc

添加MCP服务器

# Notion - Notion API（書き込み権限あり）
mmcp add notion npx -y @notionhq/notion-mcp-server

# Notion readonly - Notion API（読み取り専用）
mmcp add notion-readonly npx -y @notionhq/notion-mcp-server

# Gemini MCP - Claude Code内からGeminiを呼ぶ
mmcp add gemini npx -y @rlabs-inc/gemini-mcp

# 設定を適用
mmcp apply

______________________________________________________________________

📖 基本命令

管理MCP服务器

# 登録済みMCPサーバーを確認
mmcp list

# MCPサーバーを削除
mmcp remove 

# 例: Sequential Thinking を削除
mmcp remove sequential-thinking

管理代理

# 登録済みエージェントを確認
mmcp agents list

# エージェントを追加
mmcp agents add 

# エージェントを削除
mmcp agents remove

应用设置

# すべてのエージェントに設定を適用（マージモード：既存設定を保持）
mmcp apply --mode merge

# 置換モード：mmcp で管理していない設定を削除
mmcp apply --mode replace

# 適用後は必ずVS Codeを再起動
# Command Palette (Cmd+Shift+P) > Developer: Reload Window

重要: mmcp remove 删除MCP服务器后--mode replace 中所述修改相应参数的值。在合并模式（默认）下，删除的设置将保留在代理端。

______________________________________________________________________

📦 可注册的MCP服务器

立即使用（无需环境变量）

服务器名称｜说明｜软件包｜ |---|---|---| 文件操作 @modelcontextprotocol/server-filesystem | 浏览器自动化 @playwright/mcp | 图生成（Mermaid/CSV/XML→draw.io） @drawio/mcp |

需要环境变量

｜服务器名称｜说明｜必要的环境变量｜ |---|---|---| ｜Notion｜Notion API（有写入权限）｜ NOTION_TOKEN | 注释API（只读） NOTION_READONLY_TOKEN | 从Claude Code内呼叫Gemini GEMINI_API_KEY | |BigQuery |谷歌BigQuery| BIGQUERY_PROJECT | |Dataplex | Dataplex通用目录| DATAPLEX_PROJECT |

详细的设定方法是 docs/API_KEYS.md文件来修改标记元素的显示属性。

mmcp管理对象外（代理个别设置）

以下MCP服务器仅在特定的代理中使用，因此mmcp不进行管理，直接记载在各代理的设定文件中。

｜服务器名称｜目标代理｜原因｜ |---|---|---| 在仅限Claude Desktop等中 gh CLI和 .mcp.json 的支持。为了避免MCP的令牌消费

GitHub MCP（Claude Desktop个别设定）

在mise中安装二进制文件，直接添加到Claude Desktop的配置文件中。不需要Docker/Go/npm。

1.github-mcp-server安装：

# mise のグローバル設定にインストール（~/.config/mise/config.toml に追加される）
mise use -g ubi:github/github-mcp-server@0.32.0

2.添加到Claude Desktop配置文件：

配置文件位置： ~/Library/Application Support/Claude/claude_desktop_config.json

mcpServers 添加以下内容（`` 替换为每个用户的主目录）：

{
  "github": {
    "command": "/.local/share/mise/installs/ubi-github-github-mcp-server/0.32.0/github-mcp-server",
    "args": ["stdio"],
    "env": {
      "GITHUB_PERSONAL_ACCESS_TOKEN": "
"
    }
  }
}

备注：由于Claude Desktop不经过mise的shim，因此必须指定二进制的完整路径。

3.Fine-grained PAT的创建：

https://github.com/settings/personal-access-tokens/new访问
使用以下设置创建：

- 资源所有者：现场直播 - 存储库访问：选择所需的报告（data-analytics-platform，insight-hub等） - 权限: - 内容：阅读 - 拉取请求：读写 - 问题：阅读 - 元数据：已读 - 过期：1年 - 描述: Claude Desktop MCP - 社内リポ探索・PR作成用（github-mcp-server）

注意事项：

Copilot HTTP 版（api.githubcopilot.com/mcp/）无法访问Organization的专用存储库，因此不使用
如果在Claude Desktop的GUI“自定义连接器”中添加了GitHub，则删除（因为Organization访问有问题）
mmcp apply --mode replace 执行时，此手动设置将消失（在merge模式下保留）

______________________________________________________________________

🎯 支持的代理

mmcp支持以下AI代理：

克劳德密码 - VS Code扩张机能版Claude Code
克劳德桌面 -Claude Desktop应用程序
github副驾驶cli -GitHub Copilot命令行界面
双子座气候 -谷歌Gemini CLI

______________________________________________________________________

🔧 更高级的使用方法

通过mise实现自动化（推荐）

布置使用具有以下优点：

集中管理环境变量（.env.mcp文件）
自动设置（批量配置多个MCP服务器）
提高重现性（config.toml管理设置）
版本控制（固定Node.js和工具版本）

了解更多信息 docs/MISE.md 来修改标记元素的显示属性。

______________________________________________________________________

🔍 故障排除

如果出现问题 docs/TROUBLESHOOTING.md 来修改标记元素的显示属性。

常见问题：

______________________________________________________________________

📁 文件配置

sample-mmcp/
├── README.md                # このファイル（mmcp基本ガイド）
├── config.toml              # mise設定（タスク定義とツールバージョン管理）
├── .env.mcp.sample          # 環境変数のテンプレート（実際の設定は.env.mcpにコピー）
├── .gitignore               # Git管理対象外ファイルの設定（.env.mcpなど）
└── docs/
    ├── MISE.md              # miseによる自動化ガイド（環境変数管理とセットアップ自動化）
    ├── CLI_VS_MCP.md        # CLIツールとMCPサーバーの使い分けガイド
    ├── API_KEYS.md          # 各サービスのAPI key/トークン取得方法
    └── TROUBLESHOOTING.md   # よくある問題と解決方法

每个文件的详细信息

根目录

README.md：mmcp的基本用法和快速入门指南（此文件）
config.toml：mise设置文件。定义MCP服务器的设置任务、Node.js版本管理、环境变量读取等
.env.mcp样本：环境变量模板。实际使用时 .env.mcp 复制为并设置实际标记值
微笑。：定义不受Git管理的文件（.env.mcp、.DS_Store的下界

docs目录

MISE.md：使用mise的高级自动化指南。介绍环境变量的集中管理和设置的自动化方法
CLI_VS_MCP.md：CLI工具（gh、gcloud等）和MCP服务器的区分使用指南。应该优先哪一个，根据具体的用例进行解说
API_KEYS.md：详细解说GitHub、Notion、Gemini、Google Cloud等API key和令牌的取得步骤
故障排除.md：无法识别MCP服务器、无法读取环境变量等常见问题和解决方法

______________________________________________________________________

📚 参考链接

______________________________________________________________________

📝 许可证

此示例在MIT许可证下发布。

目录标签

开发工具ClaudeAPI集成AI代理管理本地部署配置同步自动化API管理

支持客户端

Claude DesktopClaudeCursorVS Code

接入字段

传输方式（transport，传输协议）

未说明

鉴权方式（authType，认证方式）

api-key

工具数量（toolCount，工具数）

0

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

未说明api-key部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

仍需确认：installCommand

来源信息

MCP World

mcpworld.com

/detail/aaa8580251106b3a96c9e269cc85d82c

mmcp是一个用于集中管理Model Context Protocol (MCP)服务器配置的工具，支持多AI代理同步设置。

继续浏览同类 MCP

更多开发工具 MCP（20,396）返回 MCP 目录

上一个 MCP

Sample MCP Server (Yutonishi)

Official tutorial create MCP Server using TypeScript SDK

下一个 MCP

Samsung Checkout MCP

为三星智能电视应用内支付（Samsung Checkout / DPI）开发提供API参考、代码生成和故障排除支持的MCP服务器。

Sample Mmcp

快速接入

详细介绍

mmcp的MCP服务器管理示例

📋 概要

主要功能

关于此存储库

🚀 快速启动

1. 前提条件

2.安装mmcp

3.添加MCP服务器

4.注册代理

5.应用设置

6.重新启动VS代码

🔑 需要环境变量的MCP服务器

获取标记

设置环境变量

添加MCP服务器

📖 基本命令

管理MCP服务器

管理代理

应用设置

📦 可注册的MCP服务器

立即使用（无需环境变量）

需要环境变量

mmcp管理对象外（代理个别设置）

GitHub MCP（Claude Desktop个别设定）

🎯 支持的代理

🔧 更高级的使用方法

通过mise实现自动化（推荐）

🔍 故障排除

📁 文件配置

每个文件的详细信息

根目录

docs目录

📚 参考链接

📝 许可证

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP