MCPM+克劳德代码-文档
文件日期：2025年12月9日
我创建这个存储库是为了记录一些关于将Claude Code与优秀的 MCPM.
虽然这些笔记是专门为MCPM写的，但它们可能与其他经理有关。
此仓库中的具体上下文：找到方法确保Claude Code在Ubuntu工作站环境中与外部MCP管理器“配合良好”，在该环境中，Claude和外部MCP管理者都不能通过GUI进行管理。
我想从概念和步骤上记录集成。
源文件/参考
MCP经理（MCPM）参考：
https://github.com/pathintegral-institute/mcpm.sh
文档
https://github.com/pathintegral-institute/mcpm.sh/tree/main/docs
核心理念/价值主张
在使用MCP和AI前端时，很快就会遇到一些挫折。
我故意使用AI前端一词来涵盖可能利用MCP的各种潜在公用事业：
- 聊天机器人界面（本地运行）
- 代理CLIs
这些挑战是：
- MCP工具定义需要由AI代理读取。这意味着它们构成了上下文负载。上下文加载会降低推理能力。因此，目前理想的实现方式是有选择地使用MCP工具。但从用户的角度来看，这非常麻烦。没有人愿意花一天时间打开和关闭MCP服务器和工具，以适应他们当前的环境。
- 另一个问题是，人工智能工具倾向于坚持使用自己的机制来管理MCP服务器，例如自己的MCP管理中心和库。
- 这可能是可以理解的，但很快就会变得非常烦人。跨多个IDE和CLI工作的开发人员或用户很快就会发现，必须管理多个MCP服务器定义是令人沮丧的。
- 同一用户可能通常希望使用相同的MCP，但具有多种不同的配置。例如，在工作环境中，他们可能希望拥有一个带有工作凭据的谷歌工作区MCP。但在处理自己的项目时，请使用一组单独的凭据。
像MCPM这样的集中式MCP管理器解决了许多痛点：
- 整合MCP，以便每个工具都可以指向一个MCP，然后MCP可以处理工具的聚合。
- 更无缝地管理配置文件切换。用户可以定义配置文件，绑定MCP，这些MCP大致映射到他们工作的特定环境。然后，这些配置文件可以与特定的工作区相关联。
通过CLAUDE.md指令避免草皮战争
如果像我一样，您使用Claude Code作为日常AI代理，但希望使用MCPM或其他工具进行MCP服务器管理。，那么我发现你需要坚定你的偏好！
我在我的 CLAUDE.md 比如：
用户使用MCPM管理MCP服务器。如果需要，请参阅此处的文档（文档链接）。如果您正在协助用户管理MCP服务器，请不要将其添加到Claud Code中。始终按照用户对MCPM的偏好进行操作
如果没有这个指示，我发现克劳德是（可以理解的）：
- 假设如果我想添加一个MCP，它在自己的框架内（可以理解）
- 对MCPM感到困惑。鉴于MCP有大量项目，这就是为什么我提供了存储库文档的链接以避免任何歧义。
添加这些简单的说明很快消除了这些挑战。
如何使用Profilles
在我写这篇文章的时候（2025年12月9日），Claude支持三个级别的MCP工具：
- 用户级MCP，适用于用户使用CLI的任何地方。
- 项目级MCPS，可用于为在项目上协同工作的人员整合MCP资源。这些通常在工作区中的MCP JSON文件中定义。
- 本地作用域（存储在本地配置中）
有关确切定义，请参阅参考中的官方文档片段。
______________________________________________________________________
配置文件到项目映射
MCPM和Claude Code可以结合使用的方式有几种：
- 创建几个“元”配置文件（我自己的术语）。这些反映了MCP服务器的高级联盟。您可以创建名为“个人”、“工作”、“客户项目”的配置文件
- 然后使用以下方法之一将这些配置文件映射到特定项目。
方法1:HTTP端点+项目范围（.mcp.json）
这是针对特定项目配置文件的最干净的方法。您将MCPM配置文件作为HTTP端点运行，然后在项目的 .mcp.json:
步骤1：将MCPM配置文件作为HTTP端点运行
# Run the data-analysis profile on port 8081
mcpm profile run data-analysis --http --port 8081第二步：创建 .mcp.json 在项目根目录中
{
"mcpServers": {
"data-analysis": {
"type": "http",
"url": "http://localhost:8081"
}
}
}方法2：本地作用域覆盖
对于不应共享的个人项目特定配置，请使用Claude Code的本地作用域。这将配置存储在 ~/.claude.json 在项目的路径下。
# Add an MCP server at local scope (only for this project, only for you)
claude mcp add --transport http data-tools --scope local http://localhost:8081这在以下情况下很有用：
- 您在配置文件中有个人凭据或API密钥
- 轮廓配置是实验性的
- 您不想将MCP配置提交到版本控制