使用说明
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文件，以避免将上述目录和文件推送到远程存储库。
