MCP（Model Context Protocol）是 AI Agent 与外部工具交互的开放协议。本博客通过 MCP 将文章内容、搜索、发布等能力暴露给 Claude Code、Claude Desktop 等 AI 客户端，让 Agent 可以像一位熟悉你博客的助手一样——搜索、阅读、总结、发布。
| 工具名 | 功能说明 | 参数（* 必填，? 可选） |
|---|---|---|
blog_list_postsread | 分页列出所有已发布文章，返回标题 / slug / 摘要 / 标签 / 分类 / 创建时间 | limit?=20 offset?=0 |
blog_search_postsread | 按关键字在标题和标签中模糊搜索文章 | query* limit?=10 |
blog_get_postread | 获取指定文章的完整 Markdown 内容——最核心的阅读工具 | slug* |
blog_get_tagsread | 获取热门标签统计，按文章篇数降序排列 | limit?=10 |
blog_get_graphread | 获取知识图谱——分类→标签→文章 的关联结构及文章间双链 | （无参数） |
blog_semantic_searchread | 语义向量搜索：用自然语言提问，按语义相似度匹配文章（需配置 Embedding API） | query* limit?=5 |
| 工具名 | 功能说明 | 参数（* 必填，? 可选） |
|---|---|---|
blog_create_postadmin | 创建并发布新文章，自动填充 slug / summary / tags，自动生成向量嵌入 | title* content* category* slug? summary? tags? internal_links? is_published? |
blog_recommend_linksadmin | 根据标签重叠度和分类为新文章推荐可双链的旧文章 | tags* category? exclude_slug? limit?=5 |
blog_update_postadmin | 更新已有文章的元数据（internal_links / tags / summary 等），自动更新嵌入 | slug* internal_links? tags? summary? |
blog_reindexadmin | 批量重建文章的向量嵌入索引，支持单篇或全量 | slug? force?=false |
MCP_SECRET_TOKEN， 管理工具使用 MCP_ADMIN_TOKEN。 本地 stdio 模式自动拥有管理员权限，无需 Token。复制下面这段配置到对应位置，即可在 AI 中搜索和阅读博客内容。
{
"mcpServers": {
"sjyblog": {
"type": "sse",
"url": "https://api.sjyinzju.top/mcp/sse",
"headers": {
"Authorization": "Bearer f2c89eaa57e38e40ad440bd128595be39c9577bd1689dc803c7bcff9a60f9530"
}
}
}
}将上面配置粘贴到项目或用户目录的 .claude/mcp.json。
将上面配置粘贴到 claude_desktop_config.json。
macOS: ~/Library/Application Support/Claude/ | Windows: %APPDATA%\Claude\
| 字段 | 值 |
|---|---|
| transport | sse |
| url | https://api.sjyinzju.top/mcp/sse |
| auth header | Authorization: Bearer f2c89eaa57e3... |
将上述配置中的 Authorization 替换为管理 Token：
"Authorization": "Bearer 058908cc26969bb7d9d8588a8f3ff51ec4b9b203a02db86cb7407b8e48d0509a"
管理 Token 拥有发布文章、推荐双链、更新元数据、重建索引等完整权限。 仅自己使用，勿分享给他人。
app.mount("/mcp", build_mcp_app())）deploy/README.md.env 中配置了 EMBEDDING_API_KEY