FeelUOwn MCP 服务器

使用说明内容（Markdown格式）

• 项目简介

  • FeelUOwn MCP 服务器是一个后端服务，按照 MCP（Model Context Protocol）规范，向客户端（如使用大语言模型的应用）提供可访问的资源、可调用的工具、以及可渲染的提示模板等能力。
  • 服务器端负责会话管理、能力声明，以及对外暴露的接口实现，客户端通过 JSON-RPC 与之交互，并可支持流式传输等传输模式。

• 主要功能点

  • 资源管理与访问：托管和管理可访问的数据资源（Resources），便于 LLM 客户端查询与获取数据。
  • 工具注册与执行：注册可调用的外部功能（Tools），允许客户端通过接口调用外部行为。
  • Prompt 渲染与模板帮助：定义和渲染可定制的 Prompt 模板，支持不同的交互模式。
  • JSON-RPC 通信：服务器端以 JSON-RPC 形式响应客户端请求，返回标准的 JSON 结构或通知。
  • 会话与能力声明：实现会话管理、服务器能力声明等。
  • 多传输支持与流式处理：设计为可扩展的传输方案，支持类似于 Stdio、SSE、WebSocket 等传输形态的扩展。

• 安装与运行（简要）

  • 安装依赖后，通过调用仓库提供的服务器入口来启动 MCP 服务，服务器端会配置所暴露的资源、工具及模型。
  • 运行时会绑定到指定主机和端口，客户端可通过该地址与服务器进行 JSON-RPC 通信。

• 服务器配置（JSON 配置示例，不提供可执行脚本） 结构说明：该配置用于 MCP 客户端运行时了解如何启动和连接到 MCP 服务器。本示例描述了服务器的名称、启动命令以及启动参数，实际连接由客户端按该配置启动并与服务器建立通信。 示例配置（JSON 结构）: { "server_name": "FeelUOwn MCP Server", "command": "feeluown.mcpserver.run_mcp_server", "args": [ "host=0.0.0.0", "port=12345", "debug=False" ] } 注释说明：

  • server_name：服务器的显示名称，便于在多服务器场景中区分。
  • command：用于启动服务器的命令/入口，可以是模块函数或脚本入口（本仓库实现中，核心入口函数为 run_mcp_server）。
  • args：启动参数，字符串形式的键值对（如 host、port、debug），按实际部署需要设置。

• 基本使用方法（操作简述）

  • 确认依赖已安装后，按照配置文件中的启动命令和参数启动 MCP 服务器。
  • 客户端通过指定的服务器地址（host 和 port）连接服务器，发送 JSON-RPC 请求以读取资源、执行工具、获取 Prompt 等。
  • 服务器处理请求并返回规范的 JSON-RPC 响应，客户端根据响应结果进行后续处理。
  • 如需扩展能力（新增资源/工具/Prompts），在服务器端实现相应的接口并注册到 MCP 服务中。

• 备注

  • 该实现依赖外部的 MCP 框架组件（如 mcp.server.fastmcp），并通过对 FeelUOwn 应用的内部对象（如库、播放器、集合等）的引用实现具体能力。
  • 运行时需确保服务器能访问到 FeelUOwn 应用的运行上下文（如 app 实例、库提供者等），以便资源和工具的实际执行。