首页 专区 Skill 文章 专题 AI工具 学习 编程手册

PHP MySQL jquery HTML CSS
首页 > Skill > AI Agent

Integrate Claude Agent SDK with You.com MCP server

Polar Sponsor
爱发电 赞助
.NET 9.0
立即下载

将 Claude Agent SDK 与 You.com HTTP MCP 服务器集成，支持 Python 和 TypeScript。当开发者提及 Claude Agent SDK、Anthropic Agent SDK 或将 Claude 与 MCP 工具集成时使用。

将 Claude Agent SDK 与 You.com MCP. 交互工作流程整合, 以 You.com 的 HTTP MCP 服务器设置 Claude Ag

功能概述

将 Claude Agent SDK 与 You.com MCP. 交互工作流程整合, 以 You.com 的 HTTP MCP 服务器设置 Claude Ag是一项面向实际任务的技能，主要用于Workflow.；Ssk: Language Choice.；

核心要点

  • Python 或 TypeScript. 如果 TypeScript - 问。
  • 它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
  • 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。

使用与执行

从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

将 Claude Agent SDK 与 You.com MCP 集成

用于将 Claude Agent SDK 与 You.com 的 HTTP MCP 服务器进行集成的交互式工作流。

工作流

  1. 询问：编程语言选择

    • Python 还是 TypeScript？

  2. 若选择 TypeScript —— 询问：SDK 版本

    • v1（稳定版，基于生成器）还是 v2（预览版，采用 send/receive 模式）？
    • 注意：v2 需要 TypeScript 5.2+ 以支持 await using

  3. 安装软件包

    • Python：pip install claude-agent-sdk
    • TypeScript：npm install @anthropic-ai/claude-agent-sdk

  4. 询问：环境变量配置

  5. 询问：文件位置

    • 新建文件：询问创建路径及文件名
    • 已有文件：询问需集成配置的目标文件（添加 HTTP MCP 配置）

  6. 创建或更新文件

    对于新建文件：

    • 使用下方“完整模板”章节中的完整示例代码
    • 用户在设置好 API 密钥后即可立即运行

    对于已有文件：

    • 将 HTTP MCP 服务端配置添加至现有代码中

    • Python 配置块：

      from claude_agent_sdk import query, ClaudeAgentOptions

options = ClaudeAgentOptions(
    mcp_servers={
        "ydc": {
            "type": "http",
            "url": "https://api.you.com/mcp",
            "headers": {
                "Authorization": f"Bearer {os.getenv('YDC_API_KEY')}"
            }
        }
    },
    allowed_tools=[
        "mcp__ydc__you_search",
        "mcp__ydc__you_express",
        "mcp__ydc__you_contents"
    ]
)

    • TypeScript 配置块：

      const options = {
  mcpServers: {
    ydc: {
      type: 'http' as const,
      url: 'https://api.you.com/mcp',
      headers: {
        Authorization: `Bearer ${process.env.YDC_API_KEY}`
      }
    }
  },
  allowedTools: [
    'mcp__ydc__you_search',
    'mcp__ydc__you_express',
    'mcp__ydc__you_contents'
  ]
};

完整模板

为新建文件使用以下完整模板。每个模板均已在设置 API 密钥后可直接运行。

Python 模板（完整示例）

"""
Claude Agent SDK 与 You.com HTTP MCP 服务器集成
采用 async/await 模式的 Python 实现
"""

import os
import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

# 验证环境变量
ydc_api_key = os.getenv("YDC_API_KEY")
anthropic_api_key = os.getenv("ANTHROPIC_API_KEY")

if not ydc_api_key:
    raise ValueError(
        "YDC_API_KEY 环境变量是必需的。"
        "请前往 https://you.com/platform/api-keys 获取密钥"
    )

if not anthropic_api_key:
    raise ValueError(
        "ANTHROPIC_API_KEY 环境变量是必需的。"
        "请前往 https://console.anthropic.com/settings/keys 获取密钥"
    )


async def main():
    """
    示例：搜索 AI 新闻并从 You.com MCP 服务器获取结果
    """
    # 使用 HTTP MCP 服务器配置 Claude Agent
    options = ClaudeAgentOptions(
        mcp_servers={
            "ydc": {
                "type": "http",
                "url": "https://api.you.com/mcp",
                "headers": {"Authorization": f"Bearer {ydc_api_key}"},
            }
        },
        allowed_tools=[
            "mcp__ydc__you_search",
            "mcp__ydc__you_express",
            "mcp__ydc__you_contents",
        ],
        model="claude-sonnet-4-5-20250929",
    )

    # 在启用 MCP 工具的情况下向 Claude 发起查询
    async for message in query(
        prompt="搜索本周最新的 AI 新闻",
        options=options,
    ):
        # 处理不同类型的消息
        if message.type == "text":
            print(message.content)
        elif message.type == "tool_use":
            print(f"\n[工具：{message.name}]")
            print(f"输入：{message.input}")
        elif message.type == "tool_result":
            print(f"结果：{message.content}")


if __name__ == "__main__":
    asyncio.run(main())

TypeScript v1 模板（完整示例）

/**
 * Claude Agent SDK 与 You.com HTTP MCP 服务器集成
 * 基于生成器模式的 TypeScript v1 实现
 */

import { query } from '@anthropic-ai/claude-agent-sdk';

// 验证环境变量
const ydcApiKey = process.env.YDC_API_KEY;
const anthropicApiKey = process.env.ANTHROPIC_API_KEY;

if (!ydcApiKey) {
  throw new Error(
    'YDC_API_KEY 环境变量是必需的。' +
      '请前往 https://you.com/platform/api-keys 获取密钥'
  );
}

if (!anthropicApiKey) {
  throw new Error(
    'ANTHROPIC_API_KEY 环境变量是必需的。' +
      '请前往 https://console.anthropic.com/settings/keys 获取密钥'
  );
}

/**
 * 示例：搜索 AI 新闻并从 You.com MCP 服务器获取结果
 */
async function main() {
  // 使用 HTTP MCP 配置向 Claude 发起查询
  const result = query({
    prompt: '搜索本周最新的 AI 新闻',
    options: {
      mcpServers: {
        ydc: {
          type: 'http' as const,
          url: 'https://api.you.com/mcp',
          headers: {
            Authorization: `Bearer ${ydcApiKey}`,
          },
        },
      },
      allowedTools: [
        'mcp__ydc__you_search',
        'mcp__ydc__you_express',
        'mcp__ydc__you_contents',
      ],
      model: 'claude-sonnet-4-5-20250929',
    },
  });

  // 按消息到达顺序逐条处理
  for await (const msg of result) {
    if (msg.type === 'text') {
      console.log(msg.content);
    } else if (msg.type === 'tool_use') {
      console.log(`\n[工具：${msg.name}]`);
      console.log(`输入：${JSON.stringify(msg.input, null, 2)}`);
    } else if (msg.type === 'tool_result') {
      console.log(`结果：${msg.content}`);
    }
  }
}

main().catch(console.error);

TypeScript v2 模板（完整示例）

/**
 * Claude Agent SDK 与 You.com HTTP MCP 服务器集成
 * 采用 send/receive 模式的 TypeScript v2 实现
 * 要求 TypeScript 5.2+ 以支持 'await using' 语法
 */

import { unstable_v2_createSession } from '@anthropic-ai/claude-agent-sdk';

// 验证环境变量
const ydcApiKey = process.env.YDC_API_KEY;
const anthropicApiKey = process.env.ANTHROPIC_API_KEY;

if (!ydcApiKey) {
  throw new Error(
    'YDC_API_KEY 环境变量是必需的。' +
      '请前往 https://you.com/platform/api-keys 获取密钥'
  );
}

if (!anthropicApiKey) {
  throw new Error(
    'ANTHROPIC_API_KEY 环境变量是必需的。' +
      '请前往 https://console.anthropic.com/settings/keys 获取密钥'
  );
}

/**
 * 示例：搜索 AI 新闻并从 You.com MCP 服务器获取结果
 */
async function main() {
  // 创建带 HTTP MCP 配置的会话
  // 'await using' 可确保作用域退出时自动清理资源
  await using session = unstable_v2_createSession({
    mcpServers: {
      ydc: {
        type: 'http' as const,
        url: 'https://api.you.com/mcp',
        headers: {
          Authorization: `Bearer ${ydcApiKey}`,
        },
      },
    },
    allowedTools: [
      'mcp__ydc__you_search',
      'mcp__ydc__you_express',
      'mcp__ydc__you_contents',
    ],
    model: 'claude-sonnet-4-5-20250929',
  });

  // 向 Claude 发送消息
  await session.send('搜索本周最新的 AI 新闻');

  // 接收并处理消息
  for await (const msg of session.receive()) {
    if (msg.type === 'text') {
      console.log(msg.content);
    } else if (msg.type === 'tool_use') {
      console.log(`\n[工具：${msg.name}]`);
      console.log(`输入：${JSON.stringify(msg.input, null, 2)}`);
    } else if (msg.type === 'tool_result') {
      console.log(`结果：${msg.content}`);
    }
  }
}

main().catch(console.error);

HTTP MCP 服务端配置

所有模板均使用 You.com 的 HTTP MCP 服务端，以简化集成流程：

Python：

mcp_servers={
    "ydc": {
        "type": "http",
        "url": "https://api.you.com/mcp",
        "headers": {
            "Authorization": f"Bearer {ydc_api_key}"
        }
    }
}

TypeScript：

mcpServers: {
  ydc: {
    type: 'http' as const,
    url: 'https://api.you.com/mcp',
    headers: {
      Authorization: `Bearer ${ydcApiKey}`
    }
  }
}

HTTP MCP 的优势：

  • ✅ 无需本地安装
  • ✅ 无状态请求/响应模型
  • ✅ 始终使用最新版本
  • ✅ 全环境行为一致
  • ✅ 生产就绪且具备可扩展性
  • ✅ 兼容现有 HTTP 基础设施

可用的 You.com 工具

完成配置后，Claude 可自动发现并调用以下工具：

  • mcp__ydc__you_search —— 网页与新闻搜索
  • mcp__ydc__you_express —— 基于网页上下文的 AI 问答
  • mcp__ydc__you_contents —— 网页内容提取

环境变量

两个 API 密钥均为必需项：

# 添加至 .env 文件或 shell 配置文件中
export YDC_API_KEY="your-you-api-key-here"
export ANTHROPIC_API_KEY="your-anthropic-api-key-here"

获取 API 密钥：

验证检查清单

完成前请确认以下各项：

  • 软件包已安装：claude-agent-sdk（Python）或 @anthropic-ai/claude-agent-sdk（TypeScript）
  • 环境变量已设置：YDC_API_KEY 和 ANTHROPIC_API_KEY
  • 已复制模板代码，或已将配置添加至现有文件
  • 已配置 HTTP MCP 服务端（https://api.you.com/mcp）
  • Authorization 请求头包含 Bearer ${YDC_API_KEY}
  • allowedTools 列表中已包含 You.com 工具
  • 文件具备可执行权限（Python）或可成功编译（TypeScript）
  • 已准备好使用示例查询进行测试

测试您的集成

Python：

python your-file.py

TypeScript：

# 推荐使用 tsx 快速测试
npx tsx your-file.ts

# 或先编译再运行
tsc your-file.ts && node your-file.js

常见问题

无法找到模块 @anthropic-ai/claude-agent-sdk

请安装该软件包：

# NPM
npm install @anthropic-ai/claude-agent-sdk

# Bun
bun add @anthropic-ai/claude-agent-sdk

# Yarn
yarn add @anthropic-ai/claude-agent-sdk

# pnpm
pnpm add @anthropic-ai/claude-agent-sdk
YDC_API_KEY 环境变量是必需的

请设置您的 You.com API 密钥：

export YDC_API_KEY="your-api-key-here"

获取地址：https://you.com/platform/api-keys

ANTHROPIC_API_KEY 环境变量是必需的

请设置您的 Anthropic API 密钥：

export ANTHROPIC_API_KEY="your-api-key-here"

获取地址：https://console.anthropic.com/settings/keys

MCP 连接失败，返回 401 Unauthorized

请验证您的 YDC_API_KEY 是否有效：

  1. 访问 https://you.com/platform/api-keys 检查密钥状态
  2. 确保环境变量中未混入多余空格或引号
  3. 确认 Authorization 请求头格式为：Bearer ${YDC_API_KEY}
工具不可用或未被调用

请确保 allowedTools 中包含正确的工具名称：

  • mcp__ydc__you_search（而非 you_search）
  • mcp__ydc__you_express（而非 you_express）
  • mcp__ydc__you_contents（而非 you_contents）

所有工具名称必须包含 mcp__ydc__ 前缀。

TypeScript 报错：Cannot use 'await using'

v2 SDK 要求 TypeScript 5.2+ 才能支持 await using 语法。

解决方案 1：升级 TypeScript

npm install -D typescript@latest

解决方案 2：手动清理资源

const session = unstable_v2_createSession({ /* options */ });
try {
  await session.send('Your query');
  for await (const msg of session.receive()) {
    // 处理消息
  }
} finally {
  session.close();
}

解决方案 3：改用 v1 SDK
在初始化流程中选择 v1，以获得更广泛的 TypeScript 兼容性。

其他资源

作者最新文章

MySQL 连接超时问题的终极解决方案（Go 应用实战指南）

JavaFX 中实现响应式矩形布局：保持相对宽度与间距的正确方法

如何在 Flask 中安全比对表单数据与 MySQL 数据库记录是否存在重复

如何精准定位并屏蔽网页中恶意弹窗的 JavaScript 函数

如何让 contentEditable 元素在表单提交时正常传递数据

热门AI工具

更多
Loomy

Loomy

Hot 豆包大模型

豆包大模型

 立刻MV

立刻MV

Hot Lovart

Lovart

Hot DeepSeek

DeepSeek

 二狗PPT

二狗PPT

Hot 音述AI

音述AI

Hot UP简历

UP简历

Hot

相关专题

更多
AI Agent 实战指南：从评测到落地
AI Agent 实战指南：从评测到落地

全面评测 Manus AI 与 ChatGPT、Claude、OpenAI Operator 等 AI Agent 产品，分析自动化能力、工作流与实际生产力差异。

2026.05.29

233

15

Claude 进阶使用指南
Claude 进阶使用指南

本专题面向已经具备基础使用经验的用户，深入解析 Claude 在复杂场景中的高阶应用方式，重点解决“如何让 AI 真正参与到实际工作流程中”的问题。让 Claude 成为日常工作中可持续复用的效率引擎，在内容创作、开发实践与信息处理等多个领域实现显著提效。

2026.03.27

319

16

Claude 提示词使用指南
Claude 提示词使用指南

本专题聚焦 Claude 的提示词（Prompt）设计与优化方法，围绕“如何让 AI 更准确理解需求并输出高质量结果”这一核心问题展开。内容从基础结构入手，逐步深入到复杂场景下的提示词构建策略，帮助用户建立清晰、可复用的提示词体系。

2026.03.27

314

20

Claude 新手入门教程
Claude 新手入门教程

本专题围绕 Claude 的基础使用与实际应用展开，面向零基础用户与初学者，系统梳理从“认识工具”到“高效使用”的完整路径。

2026.03.27

2331

19

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发，整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

2026.09.30

0

10

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式，涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

2026.09.30

0

14

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念，包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法，帮助新手理解LLVM编译流程中的关键层。

2026.09.30

0

12

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时，PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程，帮助用户稳定完成 PDF 图片化处理。

2026.09.30

0

26

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程，涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能，帮助用户快速掌握PixTV从创意到成片的完整制作方法。

2026.09.29

0

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

相关下载

更多
MDPHP(麦迪php框架系统)1.1
PHP 多国语言框架2.0
ujframe简单快速PHP开发框架1.0
php轻量型框架1.0
MyQEE开源PHP多项目及模块化开发框架3.0 RC2
php开源学习型框架CMVC1.2.0
PHP框架Kohana3.3.1

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Claude Code 快速上手核心指南
Claude Code 快速上手核心指南

共0课时 | 0人学习

Claude Code 官方文档
Claude Code 官方文档

共0课时 | 0人学习

Claude Code 官方中文文档
Claude Code 官方中文文档

共0课时 | 0人学习

最新文章

更多
秘塔AI生成视频怎么让镜头保持固定
PixTV文生视频怎么避免突然出现无关人物
PixTV图生视频怎么保留产品的形状和材质
腾讯混元文生视频人物动作不连贯怎么办
腾讯ima共享知识库怎么查找其他成员上传的资料
智谱清言怎么查看剩余使用额度
腾讯ima怎么导入微信里的PDF文件
秘塔AI怎么比较两版文档的修改内容
智谱清言AI写作怎么把项目经历写成案例
腾讯ima个人知识库按主题还是按文件类型整理