使用说明（Markdown 格式）

• 项目简介

  • 这是一个基于 MCP 的服务器实现，专门提供 Fediverse Enhancement Proposals（FEP）的资源、工具和提示模板。运行后，服务器会把 FEP 的仓库克隆到本地，并通过 MCP 协议向客户端暴露可检索的资源和可执行的工具。

• 主要功能点

  • 资源（Resources）
    • fep://index：提供完整的 FEP 索引（元数据的 JSON）。
    • fep://{slug}：提供单个 FEP 文档的元数据与正文内容（通过前言信息解析后合并元数据）。
  • 工具（Tools）
    • list_feps：列出所有 FEP 的元数据，可按状态筛选。
    • get_fep：获取指定 slug 的 FEP 文档。
    • search_feps：按标题、作者或内容检索 FEP。
    • refresh_repository：从远端仓库拉取最新文档。
  • 初始化与协作
    • 启动时自动克隆 FEP 仓库（带重试与指数退避）。
    • 支持通过简单的文本/JSON-RPC 形式与 LLM 客户端通信。
  • 传输与关闭
    • 通过标准输入/输出（stdio）传输，支持在进程级别优雅地关闭与清理。

• 安装步骤

  • 使用 JSR（推荐）：
    • 直接运行 deno 命令，加载 jsr 包实现 MCP 服务器。
  • 使用预构建二进制：
    • 从 Releases 页面下载对应平台的二进制并运行。
  • 从源码构建：
    • 克隆仓库，执行编译任务以生成针对目标平台的二进制文件。

• 服务器配置（客户端如何连接 MCP 服务器）

  • 说明：MCP 客户端在连接时需要知道服务器的启动命令与参数，以便启动并连接到 MCP 服务器。下面给出准确的配置信息（JSON 格式，字段含义以注释形式给出），客户端本身并不执行服务器端的内部代码，只需知道如何启动它。
  • 配置示例（JSON，文本描述）： { "mcpServers": { "fep": { "command": "deno", "args": [ "run", "--allow-ffi", "--allow-read", "--allow-write", "--allow-net", "--allow-env", "--allow-sys", "jsr:@hongminhee/fep-mcp" ] } } }
  • 字段说明：
    • mcpServers：配置一组 MCP 服务器条目。
    • fep：服务器的唯一标识名称，需与服务器实际部署的名称一致。
    • command：启动服务器所使用的可执行程序，这里为 deno。
    • args：传给启动命令的参数列表，包含运行脚本、权限开关以及要加载的 MCP 服务器标识（jsr:@hongminhee/fep-mcp）。
  • 说明：上述配置仅用于 MCP 客户端在本地或云端启动并连接到服务器。实际服务器的名称、路径与参数应与仓库中的实现保持一致。

• 基本使用方法

  • 启动服务器
    • 选择使用 JSR（推荐）或直接打包的二进制来启动。
    • 启动后，服务器会在初始化阶段克隆 FEP 仓库并暴露工具与资源接口。
  • 使用 MCP 客户端进行交互
    • 客户端通过 MCP 调用工具（如 list_feps、get_fep、search_feps、refresh_repository）或请求资源（fep://index、fep://{slug}），以 JSON-RPC 的方式获取结果。
  • 常见操作示例
    • 查询全部 FEP 的元数据并筛选 FINAL 状态的条目。
    • 获取某个 slug 的具体 FEP 文档内容以及解析后的元数据。
    • 使用 search_feps 在标题、作者和内容中进行全文检索。
  • 维护与更新
    • 通过 refresh_repository 工具可以拉取最新的 FEP 文档，并可再次查询新内容。

• 运行与退出

  • 服务器正常运行时可通过发送中断信号（如 SIGINT/SIGTERM）进行优雅关机，关机时会清理本地克隆的仓库。