BlueRose/BlueRoseNote
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
c1933f86c9e330a6318dd4236408be659ede6734
BlueRoseNote/07-Other/AI/AI Agent/MCP & Skill.md

17 KiB
Raw Blame History

TODO

  1. 让AI参考https://dreammaker.netease.com/sf上公开的蓝图与创建对应技能，方便工作。
    1. 编写 SunShineFlaw MCP
  2. 参考find-skills，编写一个适配我们组的Skill。

MCP

  • WY MCP市场:https://modelspace.netease.com/mcphub

    • DeepWiki MCP
    • POPO MCP
    • 易协作 MCP Server

  • OpenClaw:https://clawhub.ai/

  • 开发类

    • Chrome DevTools MCP。
    • BrowerMCP：Chrome浏览器专用前端视觉MCP。需要在Chrome安装对应插件。

  • 搜索类

    • Brave Search：通用网页深度搜索。 claude mcp add brave-search -- npx -y @modelcontextprotocol/server-brave-search
    • DuckDuckGo Search：无需 API Key 的隐私保护搜索，支持网页和新闻检索。claude mcp add duckduckgo-search -- npx -y duckduckgo-mcp-server
    • Sacred Scriptures：宗教典籍（如大藏经）精准检索。 claude mcp add sacred-scriptures -- npx -y @traves-theberge/sacred-scriptures-mcp
    • Open Library：全球书籍元数据与原著检索。 claude mcp add open-library -- npx -y @8ensmith/mcp-open-library
    • Paper Search：现代哲学与认知科学论文检索。 claude mcp add paper-search -- npx -y @openags/paper-search-mcp
    • OpenEnded Philosophy：非公理化逻辑推演与哲学思辨增强。 claude mcp add openended-philosophy -- npx -y @openended/philosophy-mcp

  • 存储类

    • Obsidian MCP：本地哲学笔记库同步与知识图谱构建。 claude mcp add obsidian -- npx -y @obsidian-mcp/server
    • Mem0 (OpenMemory)：用户观点长期记忆与思想进化追踪。 claude mcp add mem0 -- npx -y @mem0/mcp-server

MCP案例代码

根据 MCP 官方文档（2025-2026 版）和 GitHub 上的最新进展，SSE (Server-Sent Events) 正在逐渐被更现代的 Streamable HTTP 协议所取代。 以下是两者的核心区别及代码案例：

1. Python 案例 (使用 FastMCP)

在 Python 中，FastMCP 库极大地简化了切换过程，你只需要更改一个参数。

from fastmcp import FastMCP

mcp = FastMCP("MyRemoteServer")

@mcp.tool()
async def fetch_bilibili_hot(limit: int = 10):
    """获取B站热门视频"""
    return f"Retrieved {limit} hot videos"

# --- 运行方式 ---
# 方案 A: 传统的 SSE 模式 (已不推荐)
# mcp.run(transport="sse", host="0.0.0.0", port=8000)

# 方案 B: 现代的 Streamable HTTP 模式 (推荐)
if __name__ == "__main__":
    mcp.run(transport="streamable-http", host="0.0.0.0", port=8000)

2. TypeScript 案例 (使用 SDK)

在 TypeScript 中，你通常会配合 Express 或 Hono 框架使用。 这份参考代码将使用 TypeScript 和 Hono 框架。选择 Hono 是因为它是目前实现 Streamable HTTP（基于 Web 标准的 ReadableStream）最轻量且跨平台的方案，可以直接在 Node.js、Bun、Deno 或 Cloudflare Workers 上运行。

1. 项目初始化

首先，你需要安装核心依赖：

npm install @modelcontextprotocol/sdk hono

2. Streamable HTTP 服务端完整代码

这份代码展示了如何创建一个支持现代流式传输的 MCP 服务端，并集成一个 Bilibili 视频查询工具。

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { HttpServerTransport } from "@modelcontextprotocol/sdk/server/http.js";
import { Hono } from "hono";
import { cors } from "hono/cors";

/**
 * 1. 初始化 MCP 核心逻辑
 */
const server = new McpServer({
  name: "Bilibili-Stream-Server",
  version: "1.0.0",
});

// 注册一个示例工具：获取视频简讯
server.tool(
  "get_bili_info",
  { bvid: "string" },
  async ({ bvid }) => {
    // 模拟异步数据获取
    await new Promise(resolve => setTimeout(resolve, 500)); 
    return {
      content: [{ 
        type: "text", 
        text: `视频 ${bvid} 的实时数据：点赞 1.2w, 投币 5000 (来自 Streamable HTTP 接口)` 
      }]
    };
  }
);

/**
 * 2. 创建 Hono Web 服务
 */
const app = new Hono();

// 允许跨域（如果 Claude Desktop 或 Web 客户端需要从不同域名访问）
app.use("/*", cors());

/**
 * 3. 实现 Streamable HTTP 传输层
 * 现代规范中，我们需要处理：
 * - GET: 用于建立 SSE/流式连接
 * - POST: 用于接收客户端指令
 */
let transport: HttpServerTransport;

// 统一入口点 /mcp
app.all("/mcp", async (c) => {
  // 懒加载传输层实例，绑定到当前请求上下文
  if (!transport) {
    transport = new HttpServerTransport("/mcp", c.res);
    await server.connect(transport);
  }

  if (c.req.method === "GET") {
    // 建立流式响应 (Event Stream)
    return transport.handleGetRequest(c.req.raw, c.res.raw);
  } else if (c.req.method === "POST") {
    // 处理客户端发来的 JSON-RPC 消息
    return transport.handlePostRequest(c.req.raw, c.res.raw);
  }
});

export default {
  port: 3000,
  fetch: app.fetch,
};

console.log("🚀 Bilibili MCP Streamable Server running on http://localhost:3000/mcp");

3. 关键实现细节解析

  • HttpServerTransport: 这是 SDK 提供的现代封装。它不再像旧版 SSEServerTransport 那样需要强制区分两个 URL（如 /sse 和 /message），你可以通过逻辑判断将它们合并在同一个路由 /mcp 下。
  • 会话管理 (Session)：当你发起 GET 请求时，服务端会创建一个 Mcp-Session-Id。随后的所有 POST 请求都必须携带这个 ID，以便服务端知道该把结果“推”回哪个流。
  • 流式本质：在 handleGetRequest 中，服务器保持连接开启（Connection: keep-alive），并以 text/event-stream 格式持续输出数据块。

4. 如何在 Claude 中测试？

如果你想在 Claude Desktop 中连接这个本地流式服务器，修改你的 claude_desktop_config.json：

{
  "mcpServers": {
    "bili-remote": {
      "command": "curl",
      "args": ["-N", "http://localhost:3000/mcp"]
    }
  }
}

注意：对于远程服务器，通常直接在支持 MCP 的 IDE（如 Cursor 或 Zed）中输入 URL 即可。

5. 进阶：如何处理身份验证？

由于是 HTTP 协议，你可以轻松添加中间件来保护你的 Bilibili 接口：

app.use("/mcp", async (c, next) => {
  const token = c.req.header("Authorization");
  if (token !== "Bearer your-secret-key") {
    return c.text("Unauthorized", 401);
  }
  await next();
});

这份模板对你构建远程 MCP 有帮助吗？如果你需要将其部署到 Vercel 或 Cloudflare Workers，我可以为你提供特定的环境适配代码。

SSE 模式 (传统)

需要定义两个路由：一个用于保持 SSE 连接，一个用于接收客户端消息。

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
import express from "express";

const server = new Server({ name: "my-server", version: "1.0.0" }, { capabilities: {} });
const app = express();

let transport: SSEServerTransport;

// 1. 建立 SSE 连接通道
app.get("/sse", async (req, res) => {
  transport = new SSEServerTransport("/messages", res);
  await server.connect(transport);
});

// 2. 接收客户端发来的消息
app.post("/messages", async (req, res) => {
  if (transport) {
    await transport.handlePostMessage(req, res);
  }
});

app.listen(3000);

Streamable HTTP 模式 (现代)

使用 SDK 提供的 StreamableHTTPServer 高层封装（常见于 2025 年后的企业级模版）。

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StreamableHTTPServer } from "@modelcontextprotocol/sdk/server/http.js"; 

const mcpServer = new Server({ name: "modern-server", version: "2.0.0" }, { capabilities: { tools: {} } });

// 高层封装会自动处理路由和 Session ID
const server = new StreamableHTTPServer(mcpServer);

app.post("/mcp", async (req, res) => {
  await server.handlePostRequest(req, res);
});

app.get("/mcp", async (req, res) => {
  // 处理初始化流
  await server.handleGetRequest(req, res);
});

💡 部署建议

  • 本地开发：坚持使用 stdio。
  • 远程 Web 服务：请务必选择 streamable-http。
  • Cline/Claude 桌面端配置：在配置远程服务器时，如果对方支持新协议，配置项应为： 
    "my-remote-tool": {
  "type": "streamableHttp",
  "url": "https://api.yourserver.com/mcp"
}

详细案例

1. 项目初始化

首先，你需要安装核心依赖：

npm install @modelcontextprotocol/sdk hono

2. Streamable HTTP 服务端完整代码

这份代码展示了如何创建一个支持现代流式传输的 MCP 服务端，并集成一个 Bilibili 视频查询工具。

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { HttpServerTransport } from "@modelcontextprotocol/sdk/server/http.js";
import { Hono } from "hono";
import { cors } from "hono/cors";

/**
 * 1. 初始化 MCP 核心逻辑
 */
const server = new McpServer({
  name: "Bilibili-Stream-Server",
  version: "1.0.0",
});

// 注册一个示例工具：获取视频简讯
server.tool(
  "get_bili_info",
  { bvid: "string" },
  async ({ bvid }) => {
    // 模拟异步数据获取
    await new Promise(resolve => setTimeout(resolve, 500)); 
    return {
      content: [{ 
        type: "text", 
        text: `视频 ${bvid} 的实时数据：点赞 1.2w, 投币 5000 (来自 Streamable HTTP 接口)` 
      }]
    };
  }
);

/**
 * 2. 创建 Hono Web 服务
 */
const app = new Hono();

// 允许跨域（如果 Claude Desktop 或 Web 客户端需要从不同域名访问）
app.use("/*", cors());

/**
 * 3. 实现 Streamable HTTP 传输层
 * 现代规范中，我们需要处理：
 * - GET: 用于建立 SSE/流式连接
 * - POST: 用于接收客户端指令
 */
let transport: HttpServerTransport;

// 统一入口点 /mcp
app.all("/mcp", async (c) => {
  // 懒加载传输层实例，绑定到当前请求上下文
  if (!transport) {
    transport = new HttpServerTransport("/mcp", c.res);
    await server.connect(transport);
  }

  if (c.req.method === "GET") {
    // 建立流式响应 (Event Stream)
    return transport.handleGetRequest(c.req.raw, c.res.raw);
  } else if (c.req.method === "POST") {
    // 处理客户端发来的 JSON-RPC 消息
    return transport.handlePostRequest(c.req.raw, c.res.raw);
  }
});

export default {
  port: 3000,
  fetch: app.fetch,
};

console.log("🚀 Bilibili MCP Streamable Server running on http://localhost:3000/mcp");

3. 关键实现细节解析

  • HttpServerTransport: 这是 SDK 提供的现代封装。它不再像旧版 SSEServerTransport 那样需要强制区分两个 URL（如 /sse 和 /message），你可以通过逻辑判断将它们合并在同一个路由 /mcp 下。
  • 会话管理 (Session)：当你发起 GET 请求时，服务端会创建一个 Mcp-Session-Id。随后的所有 POST 请求都必须携带这个 ID，以便服务端知道该把结果“推”回哪个流。
  • 流式本质：在 handleGetRequest 中，服务器保持连接开启（Connection: keep-alive），并以 text/event-stream 格式持续输出数据块。

4. 如何在 Claude 中测试？

如果你想在 Claude Desktop 中连接这个本地流式服务器，修改你的 claude_desktop_config.json：

{
  "mcpServers": {
    "bili-remote": {
      "command": "curl",
      "args": ["-N", "http://localhost:3000/mcp"]
    }
  }
}

5. 进阶：如何处理身份验证？

由于是 HTTP 协议，你可以轻松添加中间件来保护你的 Bilibili 接口：

app.use("/mcp", async (c, next) => {
  const token = c.req.header("Authorization");
  if (token !== "Bearer your-secret-key") {
    return c.text("Unauthorized", 401);
  }
  await next();
});

Skill

Npx Skill

  1. npx skills find [query]：寻找Skill。
  2. npx skills add owner/repo@skill：安装技能。
    1. npx skills add ./my-local-skill：本地安装技能。

当你使用 -g 安装一个包时，该工具会被添加到你的系统环境变量中。这意味着你可以在电脑的任何路径下直接调用它，而不仅仅是在某个特定的项目文件夹里。

  • 不带 -g：包被安装在当前目录的 node_modules 中。
  • 带有 -g：包被安装在系统盘的特定全局文件夹（如 /usr/local/bin 或 AppData\Roaming\npm）。

Skill推荐

  1. 官方Skill:https://github.com/anthropics/skills
  2. 第三方ClaudeCode精选Skill包
    1. ClaudeCode:https://github.com/ComposioHQ/awesome-claude-skills
    2. Agent:https://github.com/VoltAgent/awesome-agent-skills
    3. ClaudeCode:https://github.com/VoltAgent/awesome-claude-code-subagents
    4. OpenClaw:https://github.com/VoltAgent/awesome-openclaw-skills
  3. https://skills.sh/
    1. https://skills.sh/hairyf/skills/create-skill-from-repo
  • 基础Skill
    • find-skills：在20万+Skills里自动找到所需工具。 #导航员
    • skill-creator：把你的工作流打包成可复用能力。 #工厂
    • mcp-builder：搭建服务器，连接私人数据和外部工具。 #桥梁
    • using-superpowers：强制Agent真正发挥高级能力。 #优化器
    • subagent-driven-dev：把子任务委派给其他AI并审核。 #管理者
    • agent-tools：数字瑞士军刀，处理日常事务。 #工具箱
  • 搜索相关
    • GitHub 官方 MCP:claude mcp add github -- npx -y @modelcontextprotocol/server-github
  • 进阶工具
    • brainstorming：一个关键词生成几十个独特角度和多种假设场景。 #创意生成器
    • copywriting：优化表达、打磨语调，不依赖老掉牙的一键生成模板。 #文字工匠
    • reflection：增加自我纠正循环，让Agent审核并在过程中修复错误。 #秘密武器
    • writing-plans：先构建结构大纲，确保长文不跑偏。 #架构师
    • social-content：为X、TikTok、小红书专属优化，止住下滑的手指。 #运营经理
    • marketing-ideas：生成病毒式噱头和活动概念，远超简单广告水平。 #创意总监
    • copy-editing：打磨语调、收紧流程，保留你独特的人性声音。 #高级编辑
    • content-strategy：制定内容日历，真正符合你的品牌调性。 #规划师
  • 程序相关
    • vercel-react-best-practices：前端开发黄金标准，高性能可扩展。 #前端负责人
    • browser-use：让AI实时看见并操作网页，自主网络Agent必备。 #操作员
    • test-driven-development：强制先写测试再写代码，保证每个功能经久耐用。 #质量保证
    • requesting-code-review：发布前自我审核，发现安全漏洞和潜在Bug。 #审计员
    • next-best-practices：最新Next.js架构模式，服务端组件到优化路由。 #全栈专家
    • supabase-postgres：架构设计和PostgreSQL优化，确保数据层磐石。 #数据库管理员
    • remotion-best-practices：程序化视频必备，代码驱动动画自动化营销素材。 #视频工程师
    • webapp-testing：自动运行测试套件、发现边缘情况。 #Bug猎手
  • UI设计
    • web-design-guidelines：8px网格+中性色板，界面现代一致。 #设计架构师
    • frontend-design：大胆审美，避免千篇一律的通用AI外观。 #设计工匠
    • tailwind-design-system：可扩展生产就绪的UI组件库。 #系统构建者
    • ai-image-generation：自动选DALL-E/Imagen/Gemini最佳模型。 #创意中心
    • ui-ux-pro-max：跨9大技术栈，秒出无障碍设计系统。 #逻辑设计师
    • canvas-design：生成复杂视觉艺术和海报为精心制作的PNG/PDF。 #插画师
    • infographic-pro：将复杂数据转化为专业信息图。 #数据可视化
    • content-visualizer：分析文章推荐封面图，匹配品牌氛围。 #品牌经理
  • 运营
    • Larry：自动化TikTok照片模式! OpenAI Image 3.5 + 病毒钩子。 #病毒传播专家
    • programmatic-seo：规模化生成数千个高质量SEO优化页面。 #放大器
    • marketing-psychology：社会认同+稀缺性植入产品钩子，科学不是瞎猜。 #策略师
    • seo-audit：扫描内容找SEO缺口，击败竞争对手。 #排名专家
    • audit-website：全面健康检查，识别技术摩擦点。 #顾问
    • page-cro：调整落地页，把访客变成付费客户。 #转化优化师
    • pricing-strategy：设计最大化收入又不吓跑用户的定价模型。 #变现专家
    • product-marketing-context：梳理独特卖点，识别客户确切痛点。 #定位专家
  • 文档助理。
    • pdf-pro：合并、拆分、提取复杂PDF，无手动头疼。 #文档专家
    • pptx：生成完整专业幻灯片，再也不用移动文本框。 #演示专家
    • docx：创建结构化Word文档，直接用于官方用途。 #文书
    • xlsx：带复杂公式和图表的Excel文件。 #数据分析师
    • url-to-markdown：把网页清理转换为干净Markdown，构建知识库。 #研究员
    • markdown-to-html：把草稿转换为适合博客的网页就绪HTML。 #发布者
    • format-pro：标准化文档布局，品牌输出整洁专业。 #样式师
Reference in New Issue View Git Blame Copy Permalink