MCP服务器工作区
大家好!
此存储库包含一些示例多MCP(模型上下文协议)服务器配置和Azure DevOps、Contentstack、Terraform、MongoDB和GitHub的编排设置。每个文件夹都提供了用于运行MCP服务器并将其与各种平台集成的说明和配置文件。 它将帮助您开始在项目中实现MCP服务器。
但是,始终将其用于测试或开发,避免生产
注意事项
- 在本地/基于项目运行MCP服务器。
- 要在VS Code中运行MCP服务器,请创建
.vscode在工作区中的文件夹中粘贴所需的mcp.json其中包含配置文件。保存后mcp.json在VS Code中的文件中,您将看到一个内联的“开始”按钮。单击它以启动MCP服务器。 - 对于游标编辑器,创建一个
.cursor文件夹并放置相应的配置文件(例如。,mcp.json)里面。 - 确保为要编排的平台使用正确的配置。
- 始终将配置文件中的占位符值替换为您的实际凭据和设置。
- 在全局设置中运行MCP服务器。
- 您可以更改
user-preference.json在编辑器的全局设置中添加文件,并添加所需的MCP服务器配置。 - 对于全局配置,您必须添加
mcpServers {}JSON文件中的父块。 - 只有包含以下内容的“mcp.json”脚本
mcpServers {}block旨在在全球范围内运行。 - 这允许您跨所有项目编排MCP服务器,而不仅仅是当前工作区。
- 在Cursor中,转到光标设置,搜索MCP和Integration,然后选择要使用的MCP服务器,选择多个结果以限制工具的总使用量,因为一个结果需要在128内容纳。
- 一个可以同时运行多个mcp服务器。所有这些都将同时更新代理的上下文。
- 要求:
- 使用Docker的MCP服务器(例如,Terraform、MongoDB、GitHub MCP服务器)需要Docker Desktop。
- 使用NPX命令的MCP服务器(例如Azure DevOps、Contentstack MCP服务器)需要NPX(Node.js)。
- 确保您拥有每个平台所需的凭据和API令牌。
- 代理已启用,可以访问代码库。
- 它们都是我们在本地运行的MCP服务器。
- 代理应具有对目录的受限权限访问。它应该只能访问当前目录或n-1。
- 安全与最佳实践:
- 始终添加
.vscode/,.cursor/,.env,以及.github/到你的.gitignore文件,以防止推送可能包含凭据或敏感指令的编辑器配置文件夹、机密和工作流文件。 - 使用
.env文件,以安全地存储敏感的环境变量和机密。永远不要承诺你的.env文件到版本控制。 - 定期检查您的配置文件,以确保没有泄露任何秘密。
- 尝试限制代理对.env文件的访问/不要更新代理内容中的.env文件,以防止恶意更改。
- 目录结构和用法:
- 您需要五个主要目录:
- .cursor 或 .vscode:对于配置文件, mcp.json,以及代理指令文件。 - .env:用于存储令牌、凭据和机密。 - .github:用于存储工作流和MDC指令文件,供代理遵循。 - github-mcp:GitHub MCP服务器配置和说明。 - azure-devops-mcp:有关Azure DevOps MCP服务器配置和说明。 - 在Cursor中,您可以通过Cursor设置(常规和项目特定)添加配置。对于特定于项目的配置,请在 .cursor 目录。 - .gitignore 文件,以避免将上述目录和文件推送到远程存储库。
