内容
# Equinix 服务器仓库
官方仓库，包含模型上下文协议（MCP）服务器以及将其与 AI 助手和语言模型集成的指南。
## 📋 目录
- [概述](#概述)
- [可用服务器](#可用服务器)
- [服务器工具](#服务器工具)
- [安装和快速入门](#-安装和快速入门)
- [配置](#配置)
- [故障排除](#-故障排除)
- [支持](#-支持)
## 概述
本仓库提供标准化的 MCP 服务器实现，使 AI 助手和语言模型能够安全地与外部 API 和服务交互。MCP 是一种开放协议，允许结构化访问资源和操作。
> **状态：** 部分服务器可能处于私有测试阶段。请联系您的账户代表或提交查询以了解测试访问权限。
## 可用服务器
| 服务器名称 | 端点 | 描述 |
|-------------|----------|-------------|
| **Fabric 服务器** | `https://mcp.equinix.com/fabric` | 与 Equinix Fabric 资源交互 |
## 服务器工具
每个 MCP 服务器都暴露了一组用于与其各自 API 交互的工具。工具按服务器组织如下。
### Fabric 服务器
**位置：** `https://mcp.equinix.com/fabric`
可用工具：
- 参考：[所有 Fabric 工具](./docs/TOOLS_REFERENCE.md#fabric-mcp-tools)
## 🌐 服务器端点
MCP 服务器可以通过支持模型上下文协议的标准化 HTTP 端点访问。这些端点与任何兼容的 MCP 客户端配合使用。
**标准配置：**
```json
{
"servers": {
"fabric": {
"type": "http",
"url": "https://mcp.equinix.com/fabric"
}
}
}
```
> **注意：** 这些 URL 设计仅供合规的 MCP 客户端使用。直接在浏览器中访问将返回 `405 方法不允许` 错误。请改用 VS Code、Claude Desktop 或 MCP Inspector。
## 🔌 安装和快速入门
选择您首选的客户端进行快速设置：
| 客户端 | 安装 | 指南 |
|--------|--------------|-------|
| **VS Code** | 从 Marketplace 安装“MCP 服务器”扩展 | [VS Code MCP 指南](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) |
| **Claude Desktop** | 在设置中通过“添加自定义连接器”添加 | [Claude Desktop 指南](https://modelcontextprotocol.io/docs/develop/connect-remote-servers) |
| **Visual Studio** | 内置支持（VS 2022 或更高版本） | [Visual Studio 指南](https://learn.microsoft.com/en-us/visualstudio/ide/mcp-servers?view=vs-2022) |
| **Cursor IDE** | 通过 Cursor 设置面板安装 | [Cursor MCP 指南](https://docs.cursor.com/context/model-context-protocol) |
### 🚀 快速设置
Equinix MCP 新手？从这里开始： **[快速入门指南 →](./docs/getting-started.md)**
本指南涵盖：
- 身份验证（OAuth 2.1 — DCR/CIMD）
- 设置您首选的 MCP 客户端
- 测试连接
- 运行您的第一个命令
- 安全最佳实践
## 配置
### 基本设置
1. 从 [可用服务器](#可用服务器) 表中复制 MCP 服务器端点 URL
2. 将其添加到客户端的配置文件中
4. 在 MCP 客户端界面中验证连接
## ⚠️ 故障排除
| 问题 | 解决方案 |
|-------|----------|
| **连接错误** | 验证您的网络连接，并确保在 MCP 客户端配置中正确输入了服务器 URL |
| **工具未显示** | 重启您的 IDE/客户端应用程序，并验证 MCP 服务器是否正确安装并连接 |
| **HTTP 405 错误** | 在网页浏览器中访问端点时出现此错误。请改用您的 MCP 客户端（VS Code、Claude Desktop 等）或 [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector) |
| **身份验证失败** | 确保您已完成客户端浏览器同意流程，并且 MCP 客户端配置了正确的服务器 URL。如果客户端无法打开浏览器，请检查弹出窗口阻止程序和操作系统 URL 处理程序。 |
| **响应缓慢** | 检查您的网络延迟和服务器状态。如果网络状况不佳，请考虑重试请求 |
## 🆘 支持
- **文档：** [`/docs` 中的完整文档](./docs/)
- **问题：** [报告错误或请求功能](https://github.com/equinix/mcp/issues)
- **电子邮件：** 通过 fabric-intelligence-support@equinix.com 联系支持团队，提出特定的服务器需求
## 📚 文档索引
| 资源 | 目的 |
|----------|---------|
| [快速入门](./docs/getting-started.md) | 首次设置和配置 |
| [Fabric 服务器](./docs/servers/fabric-mcp.md) | 连接管理工作流程和示例 |
## 其他资源
- [MCP 官方文档](https://modelcontextprotocol.io/)
- [MCP Inspector 工具](https://modelcontextprotocol.io/docs/tools/inspector)
- [构建自定义 MCP 客户端](https://modelcontextprotocol.io/docs/develop/client)
