项目简介

'@tailor-platform/tailor-mcp' 是 Tailor 平台提供的 MCP (Model Context Protocol) 服务器的安装和配置工具。它本身并非 MCP 服务器的直接实现，而是通过安装和管理 'tailorctl' 命令行工具，来提供 MCP 服务器的功能。'tailorctl' 包含了 Tailor 平台 MCP 服务器的完整实现，'@tailor-platform/tailor-mcp' 作为一个 npm 包，简化了 'tailorctl' 的安装过程，并提供了一些便捷的命令来启动和配置 MCP 服务器。

主要功能点

简化安装 Tailor MCP 服务器: 通过 npm 包快速安装 'tailorctl'，无需手动下载和配置。
跨平台支持: 自动检测操作系统和架构，下载并安装适配的 'tailorctl' 版本，支持 macOS, Linux, Windows 等主流平台。
提供丰富的 MCP 工具: 内置多种 MCP 工具，如资源创建、更新、查询、删除，GraphQL 查询等，方便 LLM 应用进行上下文交互。
支持多种认证方式: 可以通过命令行交互式登录或使用 Personal Access Token (PAT) 进行身份验证。
灵活的服务器配置: 支持通过 JSON 配置定义 MCP 服务器，方便集成到各种 LLM 客户端。
支持 HTTP 传输协议: 除了默认的 Stdio，还支持通过 HTTP 协议启动 MCP 服务器，便于网络访问。

安装步骤

安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm (Node Package Manager)。
全局安装 '@tailor-platform/tailor-mcp': 在终端运行以下命令进行全局安装：
```
npm install -g @tailor-platform/tailor-mcp
```
这将安装 '@tailor-platform/tailor-mcp' 包，并自动下载和安装 'tailorctl' 命令行工具到你的系统。

服务器配置

MCP 服务器需要配合 MCP 客户端使用，客户端需要配置服务器的启动信息才能连接。以下是针对不同 MCP 客户端的服务器配置示例 (JSON 格式)，你只需要将以下 JSON 配置信息填入到你的 MCP 客户端配置中即可。

配置示例 (假设服务器名称为 "tailor"):

{
  "mcpServers": {
    "tailor": {  // 服务器名称，可以自定义
      "command": "npx", // 启动命令，固定为 "npx"
      "args": [        // 启动参数
        "-y",          // 自动确认执行
        "@tailor-platform/tailor-mcp", //  执行的 npm 包名
        "mcp"         //  启动 MCP 服务器的命令
      ],
      "env": {         // 环境变量
        "TAILOR_TOKEN": "YOUR_TAILOR_PLATFORM_TOKEN" //  Tailor Platform 认证 Token，你需要替换为你的实际 Token
      }
    }
  }
}

配置参数说明:

'server name': MCP 服务器的名称，可以自定义，用于在客户端中标识不同的 MCP 服务器连接。例如 "tailor"。
'command': 启动服务器的命令，这里固定使用 'npx'，用于执行 npm 包。
'args': 启动参数，一个字符串数组，用于传递给启动命令。
- '"-y"': 可选参数，用于在使用 'npx' 执行 npm 包时自动确认执行，避免交互式提示。
- '"@tailor-platform/tailor-mcp"': 要执行的 npm 包名称，即 '@tailor-platform/tailor-mcp'。
- '"mcp"': 传递给 '@tailor-platform/tailor-mcp' 包的命令，用于启动 MCP 服务器。
'env': 环境变量，一个 JSON 对象，用于设置 MCP 服务器运行时的环境变量。
- '"TAILOR_TOKEN"': 必须配置，用于 Tailor Platform 的身份验证。你需要替换 '"YOUR_TAILOR_PLATFORM_TOKEN"' 为你从 Tailor Platform 控制台获取的 Personal Access Token (PAT)。

获取 Tailor Platform Token:

访问 console.tailor.tech 并创建账号或登录。
按照 README 中的 "Authentication" 章节的说明，使用命令 'npx @tailor-platform/tailor-mcp auth pat create' 创建 Personal Access Token (PAT)。
将生成的 PAT 字符串 (例如 'tpp_xxxxxxxxxxxxxxxxx') 替换到上述 JSON 配置中的 '"YOUR_TAILOR_PLATFORM_TOKEN"' 位置。

基本使用方法

启动 MCP 服务器: 当 MCP 客户端尝试连接配置的 "tailor" 服务器时，客户端会根据上述配置，通过 'npx @tailor-platform/tailor-mcp mcp' 命令启动 MCP 服务器。
使用 MCP 工具: MCP 服务器启动后，客户端可以通过 JSON-RPC 协议调用服务器提供的各种工具，例如：
- 'create_resource': 创建资源
- 'fetch_resource_by_trn': 根据 TRN (Tailor Resource Name) 获取资源
- 'query_graphql': 执行 GraphQL 查询
- 等等。
具体的工具列表和使用方法可以参考 Tailor Platform 的官方文档和 MCP 协议规范。
HTTP 传输 (可选): 如果你需要使用 HTTP 协议连接 MCP 服务器，可以使用以下命令手动启动 HTTP 服务器：
```
npx tailorctl mcp --transport=http --listen=0.0.0.0:9000
```
然后，在 MCP 客户端中配置连接到 'http://0.0.0.0:9000' 的 MCP 服务器。

注意: '@tailor-platform/tailor-mcp' 主要负责安装和启动 'tailorctl' MCP 服务器。更详细的 MCP 服务器功能、工具使用和 Tailor Platform 平台功能，请参考 Tailor Platform 官方文档。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息