使用说明内容（Markdown格式）

项目简介
- Swift Selena 是一个 MCP 服务器实现，专注于为 Claude AI 提供 Swift 代码分析相关的上下文信息和功能。它通过 MCP 协议与客户端通信，托管资源、注册并执行工具、定义和渲染 Prompts，并支持会话管理与多传输通道。
主要功能点
- 资源管理：提供代码分析所需的数据资源接口，支持读取、查询和缓存分析数据。
- 工具注册与执行：内置一组分析工具，如项目初始化、文件搜索、符号与类型分析、导入分析等，可被客户端调用。
- 提供 Prompt/模板能力：为 LLM 提供可定制的对话模板与上下文渲染。
- 多客户端支持：可同时为 Claude Code、Claude Desktop 等客户端提供服务，具备会话隔离。
- MCP 协议实现：实现 MCP 请求/响应的处理、会话管理及能力声明，支持不同传输协议（如 STDIO、WebSocket 等）。
- 日志与调试：提供服务器启动、工具执行、LSP 连接状态等日志输出，便于排查问题。
安装步骤
- 克隆仓库并进入项目目录
- 构建发布版本（推荐用于生产）
  - 执行 make build-release
- 备用：直接使用 swift 构建
  - swift build -c release -Xswiftc -Osize
- 构建产物默认位置为 .build/release/Swift-Selena
服务器配置（供 MCP 客户端连接所需的最小字段说明）
- MCP 客户端要连接到服务器，至少需要提供以下配置信息中的字段：server_name、command、args。
- 字段解释如下：
  - server_name：用于在客户端识别该 MCP 服务器的名称，例如 swift-selena。
  - command：启动服务器的完整执行路径，示例为 /path/to/Swift-Selena/.build/release/Swift-Selena。
  - args：启动时附加的参数数组，若无参数则为空数组。
- JSON 配置示例（直接以文本形式给出，便于复制到客户端配置中）： { "server_name": "swift-selena", "command": "/path/to/Swift-Selena/.build/release/Swift-Selena", "args": [] }
- 说明：以上路径请根据实际环境进行替换；客户端不需要理解内部实现细节，只需掌握该服务器的启动命令及参数。
基本使用方法
- 运行服务器
  - 在项目根目录执行构建命令后，直接运行生成的可执行文件（如 .build/release/Swift-Selena）即可启动 MCP 服务器。
- 连接客户端
  - 在 Claude Desktop/Claude Code 的配置中添加服务器信息（server_name、command、args），以建立与 MCP 服务器的连接。
- 常用操作
  - 初始化项目、查找文件、分析符号、查看类型层次、分析导入、执行工具等，通过 MCP 客户端发起请求，服务器返回相应的 JSON-RPC 响应。
- 日志查看
  - 服务器日志默认输出到 ~/.swift-selena/logs/server.log，实时跟踪可帮助排错。
进一步参考
- 服务器的运行状态与调试信息可在日志中查看，包括服务器启动、工具执行、LSP 连接状态等。

关键词

信息