Struct YggMcpServer 

pub struct YggMcpServer;

MCP 服务器实例（无状态：每个请求由 service_factory 新建一份）。

共享状态（DB 连接等）通过 get_conn() 全局池获取，无需在实例里持有。 工具方法分散在各 tools/*.rs 的 impl YggMcpServer 块里。

Implementations

impl YggMcpServer

fn combined_router() -> ToolRouter<Self>

组合所有工具组的路由表。新增工具组时在此追加一行。

impl YggMcpServer

pub fn list_comments_tool_attr() -> Tool

Generated tool metadata function for list_comments

fn list_comments( &self, Parameters: Parameters<ListCommentsParams>, Extension: Extension<Parts>, ) -> Pin<Box<dyn Future<Output = Result<CallToolResult, McpError>> + Send + '_>>

列出评论（分页，可按状态筛选）。要求 write 作用域。

pub fn approve_comment_tool_attr() -> Tool

Generated tool metadata function for approve_comment

fn approve_comment( &self, Parameters: Parameters<CommentIdParams>, Extension: Extension<Parts>, ) -> Pin<Box<dyn Future<Output = Result<CallToolResult, McpError>> + Send + '_>>

通过指定评论（同时递归通过所有 pending 祖先评论）。要求 write 作用域。

pub fn delete_comment_tool_attr() -> Tool

Generated tool metadata function for delete_comment

fn delete_comment( &self, Parameters: Parameters<CommentIdParams>, Extension: Extension<Parts>, ) -> Pin<Box<dyn Future<Output = Result<CallToolResult, McpError>> + Send + '_>>

删除指定评论（软删除：设置 deleted_at 与 status=trash）。要求 write 作用域。

pub fn set_comment_status_tool_attr() -> Tool

Generated tool metadata function for set_comment_status

fn set_comment_status( &self, Parameters: Parameters<SetCommentStatusParams>, Extension: Extension<Parts>, ) -> Pin<Box<dyn Future<Output = Result<CallToolResult, McpError>> + Send + '_>>

设置评论状态（approved/spam/trash）。要求 write 作用域。

pub fn comments_router() -> ToolRouter<Self>

impl YggMcpServer

pub fn upload_media_tool_attr() -> Tool

Generated tool metadata function for upload_media

fn upload_media( &self, Parameters: Parameters<UploadMediaParams>, Extension: Extension<Parts>, ) -> Pin<Box<dyn Future<Output = Result<CallToolResult, McpError>> + Send + '_>>

从一个图片 URL 抓取并入库（服务端转 WebP 若更小），返回可直接嵌入 Markdown 正文的 /uploads/... URL。要求 write 作用域。

仅接受 https:// URL；服务端做 SSRF 防护（私网/回环/保留段拒绝、 DNS 锁定防 rebinding、禁重定向、体积上限）。二进制不经 JSON-RPC。

pub fn media_router() -> ToolRouter<Self>

impl YggMcpServer

pub fn create_post_tool_attr() -> Tool

Generated tool metadata function for create_post

fn create_post( &self, Parameters: Parameters<CreatePostParams>, Extension: Extension<Parts>, ) -> Pin<Box<dyn Future<Output = Result<CallToolResult, McpError>> + Send + '_>>

创建一篇新文章（草稿或直接发布）。要求 write 作用域。

pub fn update_post_tool_attr() -> Tool

Generated tool metadata function for update_post

fn update_post( &self, Parameters: Parameters<UpdatePostParams>, Extension: Extension<Parts>, ) -> Pin<Box<dyn Future<Output = Result<CallToolResult, McpError>> + Send + '_>>

更新指定文章（PATCH 语义：仅更新提供的字段）。要求 write 作用域。 仅文章原作者可更新。

pub fn publish_post_tool_attr() -> Tool

Generated tool metadata function for publish_post

fn publish_post( &self, Parameters: Parameters<PostIdParams>, Extension: Extension<Parts>, ) -> Pin<Box<dyn Future<Output = Result<CallToolResult, McpError>> + Send + '_>>

发布指定文章（设置 status=published 与 published_at）。要求 write 作用域。

pub fn trash_post_tool_attr() -> Tool

Generated tool metadata function for trash_post

fn trash_post( &self, Parameters: Parameters<PostIdParams>, Extension: Extension<Parts>, ) -> Pin<Box<dyn Future<Output = Result<CallToolResult, McpError>> + Send + '_>>

将指定文章移入回收站（软删除：设置 deleted_at）。要求 write 作用域。

pub fn delete_post_tool_attr() -> Tool

Generated tool metadata function for delete_post

fn delete_post( &self, Parameters: Parameters<PostIdParams>, Extension: Extension<Parts>, ) -> Pin<Box<dyn Future<Output = Result<CallToolResult, McpError>> + Send + '_>>

彻底删除指定文章（物理删除，不可恢复）。要求 write 作用域。

pub fn posts_router() -> ToolRouter<Self>

impl YggMcpServer

pub fn search_posts_tool_attr() -> Tool

Generated tool metadata function for search_posts

fn search_posts( &self, Parameters: Parameters<SearchPostsParams>, Extension: Extension<Parts>, ) -> Pin<Box<dyn Future<Output = Result<CallToolResult, McpError>> + Send + '_>>

全文搜索已发布文章（知识库）。返回标题/slug/摘要/标签。

pub fn get_post_tool_attr() -> Tool

Generated tool metadata function for get_post

fn get_post( &self, Parameters: Parameters<GetPostParams>, Extension: Extension<Parts>, ) -> Pin<Box<dyn Future<Output = Result<CallToolResult, McpError>> + Send + '_>>

按 slug 取单篇已发布文章（草稿对 read 不可见）。

pub fn list_tags_tool_attr() -> Tool

Generated tool metadata function for list_tags

fn list_tags( &self, Extension: Extension<Parts>, ) -> Pin<Box<dyn Future<Output = Result<CallToolResult, McpError>> + Send + '_>>

列出全部标签 + 各自关联的已发布文章数。

pub fn read_router() -> ToolRouter<Self>

impl YggMcpServer

pub fn run_code_tool_attr() -> Tool

Generated tool metadata function for run_code

fn run_code( &self, Parameters: Parameters<RunCodeParams>, Extension: Extension<Parts>, ) -> Pin<Box<dyn Future<Output = Result<CallToolResult, McpError>> + Send + '_>>

在容器沙箱内执行代码并返回输出。要求 admin 作用域。

pub fn runner_router() -> ToolRouter<Self>

impl YggMcpServer

pub fn get_settings_tool_attr() -> Tool

Generated tool metadata function for get_settings

fn get_settings( &self, Parameters: Parameters<GetSettingsParams>, Extension: Extension<Parts>, ) -> Pin<Box<dyn Future<Output = Result<CallToolResult, McpError>> + Send + '_>>

读取站点回收站设置。要求 admin 作用域。

pub fn update_settings_tool_attr() -> Tool

Generated tool metadata function for update_settings

fn update_settings( &self, Parameters: Parameters<UpdateSettingsParams>, Extension: Extension<Parts>, ) -> Pin<Box<dyn Future<Output = Result<CallToolResult, McpError>> + Send + '_>>

更新站点回收站设置。要求 admin 作用域。retention_days 会 clamp 到 [1, 365]。

pub fn settings_router() -> ToolRouter<Self>

impl YggMcpServer

pub fn create_tag_tool_attr() -> Tool

Generated tool metadata function for create_tag

fn create_tag( &self, Parameters: Parameters<CreateTagParams>, Extension: Extension<Parts>, ) -> Pin<Box<dyn Future<Output = Result<CallToolResult, McpError>> + Send + '_>>

创建一个新标签。若同名标签已存在则返回已有标签 id。要求 write 作用域。

pub fn rename_tag_tool_attr() -> Tool

Generated tool metadata function for rename_tag

fn rename_tag( &self, Parameters: Parameters<RenameTagParams>, Extension: Extension<Parts>, ) -> Pin<Box<dyn Future<Output = Result<CallToolResult, McpError>> + Send + '_>>

重命名指定标签。要求 write 作用域。

pub fn tags_router() -> ToolRouter<Self>

Trait Implementations

impl Clone for YggMcpServer

fn clone(&self) -> YggMcpServer

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for YggMcpServer

fn default() -> YggMcpServer

Returns the “default value” for a type.

impl ServerHandler for YggMcpServer

单一 ServerHandler：工具调度委托给合并后的路由表。 router = Self::combined_router() 让 tool_handler 宏生成的 call_tool/list_tools/get_tool 全部走组合路由。

async fn call_tool( &self, request: CallToolRequestParams, context: RequestContext<RoleServer>, ) -> Result<CallToolResponse, ErrorData>

Handle a tools/call request from a client.

async fn list_tools( &self, _request: Option<PaginatedRequestParams>, context: RequestContext<RoleServer>, ) -> Result<ListToolsResult, ErrorData>

fn get_tool(&self, name: &str) -> Option<Tool>

Get a tool definition by name.

fn get_info(&self) -> ServerInfo

fn ping( &self, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + MaybeSendFuture

fn initialize( &self, request: InitializeRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<InitializeResult, ErrorData>> + MaybeSendFuture

fn supported_protocol_versions(&self) -> Cow<'static, [ProtocolVersion]>

Return the protocol versions supported by this server.

fn discover( &self, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<DiscoverResult, ErrorData>> + MaybeSendFuture

Return this server’s discovery information.

fn complete( &self, request: CompleteRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<CompleteResult, ErrorData>> + MaybeSendFuture

fn set_level( &self, request: SetLevelRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + MaybeSendFuture

fn get_prompt( &self, request: GetPromptRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<GetPromptResponse, ErrorData>> + MaybeSendFuture

fn list_prompts( &self, request: Option<PaginatedRequestParams>, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<ListPromptsResult, ErrorData>> + MaybeSendFuture

fn list_resources( &self, request: Option<PaginatedRequestParams>, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<ListResourcesResult, ErrorData>> + MaybeSendFuture

fn list_resource_templates( &self, request: Option<PaginatedRequestParams>, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<ListResourceTemplatesResult, ErrorData>> + MaybeSendFuture

fn read_resource( &self, request: ReadResourceRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<ReadResourceResponse, ErrorData>> + MaybeSendFuture

fn accepted_subscription_filter( &self, requested: &SubscriptionFilter, ) -> Option<SubscriptionFilter>

Return the subset of a requested notification filter this server accepts.

fn listen( &self, context: SubscriptionContext, ) -> impl Future<Output = Result<(), ErrorData>> + MaybeSendFuture

Run one established subscription until it is cancelled or closed gracefully.

fn subscribe( &self, request: SubscribeRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + MaybeSendFuture

👎Deprecated:

resources/subscribe is legacy-only; implement accepted_subscription_filter and listen for protocol version 2026-07-28

fn unsubscribe( &self, request: UnsubscribeRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + MaybeSendFuture

👎Deprecated:

resources/unsubscribe is legacy-only; subscriptions/listen is cancelled through its request lifecycle

fn on_custom_request( &self, request: CustomRequest, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<CustomResult, ErrorData>> + MaybeSendFuture

fn on_cancelled( &self, notification: CancelledNotificationParam, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + MaybeSendFuture

fn on_progress( &self, notification: ProgressNotificationParam, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + MaybeSendFuture

fn on_initialized( &self, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + MaybeSendFuture

fn on_roots_list_changed( &self, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + MaybeSendFuture

fn on_custom_notification( &self, notification: CustomNotification, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + MaybeSendFuture

fn get_task( &self, request: GetTaskParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<GetTaskResult, ErrorData>> + MaybeSendFuture

SEP-2663 tasks/get: return the current [DetailedTask] state.

fn update_task( &self, request: UpdateTaskParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + MaybeSendFuture

SEP-2663 tasks/update: accept responses to outstanding in-task input requests. Returns an empty acknowledgement on success.

fn cancel_task( &self, request: CancelTaskParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + MaybeSendFuture

SEP-2663 tasks/cancel: cooperative cancellation. Returns an empty acknowledgement; the task’s observable status may lag.