Claude Agent SDK + Neo4j 集成
概述
Claude Agent SDK 是 Anthropic 的 Python 工具箱，用于构建 AI 代理。基于同一代理框架（驱动 Claude Code），它提供自动上下文管理、丰富的工具生态系统、细粒度权限以及生产必备功能，如错误处理和会话管理。
安装
pip install claude-agent-sdk neo4j核心功能
-
跨会话的自动上下文管理
-
原生 MCP（模型上下文协议）服务器支持
-
使用
@tool装饰器创建自定义工具 -
子代理编排，实现并行和专用工作流
-
会话持久化与恢复
-
支持多个 LLM 提供商（Anthropic API、AWS Bedrock、Google Vertex AI、Microsoft Azure）
扩展点
MCP 身份验证
支持的机制
✅ 环境变量（STDIO 传输） - 对于本地 MCP 服务器（如 mcp-neo4j-cypher），凭证通过生成时的 env 参数传递。
✅ HTTP 头部（HTTP/SSE 传输） - 对于远程 MCP 服务器，通过 headers 参数传递 API 密钥或 Bearer 令牌（例如 Authorization: Bearer ${API_TOKEN}）。
❌ OAuth 2.0（客户端内） - SDK 当前不支持在客户端内进行 OAuth2 MCP 认证。
配置示例（STDIO 传输）
cypher_mcp_config = {
"type": "stdio",
"command": "uvx",
"args": ["mcp-neo4j-cypher"],
"env": {
"NEO4J_URI": os.environ.get("NEO4J_URI"),
"NEO4J_USERNAME": os.environ.get("NEO4J_USERNAME"),
"NEO4J_PASSWORD": os.environ.get("NEO4J_PASSWORD"),
"NEO4J_DATABASE": os.environ.get("NEO4J_DATABASE", "neo4j")
}
}