Xcode Assistant Copilot Server

关键词

本地服务器OpenAI代理Xcode 集成Copilot 支持会话管理

使用说明内容（Markdown格式）

  • 项目简介 该项目是一个本地服务器，作为 OpenAI 兼容代理，能够将 Xcode Copilot 的请求转发或通过内置的 MCP 机制进行工具调用与上下文管理，提供可本地化的上下文服务与能力扩展。

  • 主要功能点

    • 提供 OpenAI 风格的接口（如 /health、/v1/models、/v1/chat/completions）并支持流式响应
    • 支持直接代理 Copilot API 的请求，或在 MCP 模式下通过内部代理循环执行工具调用
    • 提供 MCP 相关配置与桥接能力，用于在本地环境中管理资源、工具与提示模板
    • 具备会话管理、能力声明与多传输支持（HTTP/SSE 等）
    • 支持本地化的配置文件，默认在用户主目录创建配置，便于定制

  • 安装步骤

    • 通过 Homebrew 安装（官方命令：brew install mobile-ar/xcode-assistant-copilot-server/xcode-assistant-copilot-server）
    • 或从源码构建：使用 Swift 构建并安装可执行文件到系统路径
    • 第一次运行时会创建默认配置文件，若需要进行 GitHub 登录认证，请按提示完成设备码登录流程

  • 服务器配置（MCP 客户端需要的最小信息） 下面给出 MCP 客户端在连接时需要的最小配置信息（JSON 格式，描述性信息，非代码块展示，便于理解）： { "serverName": "xcode", "type": "local", "command": "xcrun", "args": ["mcpbridge"], "allowedTools": ["*"], "timeout": 60 } 说明：

    • serverName：在 MCP 客户端中用于标识的服务器名称
    • type：服务器类型，local 表示在本地启动并通过命令行启动 MCP 桥接工具
    • command / args：启动 MCP 桥接工具的命令及参数（如需要，请按实际环境调整）
    • allowedTools：允许 Copilot 调用的工具列表，["*"] 表示允许全部
    • timeout：工具调用的超时时间，单位为秒

  • 基本使用方法

    • 启动服务器：xcode-assistant-copilot-server --port 8080
    • 在 Xcode 中设置本地托管提供者，端口与服务器保持一致
    • 如启用 MCP，确保 MCP 桥接工具可用并在配置中正确指向相应命令与参数
    • 如需更改端口、日志级别或配置文件路径，可通过命令行参数完成

服务器信息

访问项目