MCP 协议接入指南:把 LinkAdmin 能力暴露给任意 AI 客户端

2026-09-12 6,870 次阅读 综合

从 php-mcp/server 的安装配置讲起,手把手带你把链接查询、内容检索封装为 MCP Tool,并在 Claude Desktop 中完成调用验证,附完整调试思路与常见报错排查。

为什么需要 MCP

MCP(Model Context Protocol)是 Anthropic 提出的「让模型调用外部工具」的开放协议。它把工具抽象为可被 LLM 理解的「函数 + 参数」,让任意兼容 MCP 的客户端(Claude Desktop、Cursor、Cline 等)都能无缝调用我们的能力。

对于 LinkAdmin 而言,这意味着用户可以直接在 Claude 里说「帮我查一下最近 7 天新发布的 10 篇博客」,而不用切换到后台页面手动操作。

5 分钟接入

通过 composer 安装 php-mcp/server,然后在插件入口声明要暴露的工具即可:

Bash
composer require php-mcp/server

# 在插件 Config/mcp.php 注册工具
return [
    'tools' => [
        \App\Web\Mcp\Tools\SearchNews::class,
        \App\Web\Mcp\Tools\GetNews::class,
    ],
];
Claude Desktop 通过 stdio 与本地 MCP server 通信,确保防火墙未拦截 stdin/stdout 即可。