案例目标本案例展示了如何将LlamaIndex中的代理工具转换为MCP(Model Context Protocol)工具实现以下目标演示如何将LlamaHub中的代理工具转换为MCP工具以Notion工具为例展示完整的转换过程创建并配置FastMCP服务器注册LlamaIndex工具到MCP服务器运行MCP服务器并提供工具访问技术栈与核心依赖llama-index-tools-notionmcpfastmcpFastMCPNotionToolSpecModel Context Protocol (MCP)本案例主要使用LlamaIndex的Notion工具规范和FastMCP服务器将LlamaIndex代理工具转换为MCP工具使其可以通过MCP协议被其他应用程序访问。环境配置1安装依赖包!pip install llama-index-tools-notion mcp fastmcp2导入MCP服务器依赖# Import dependencies for Model Context Protocol (MCP) fastMCP serverfrom typing import Any, Dict, List, Optionalfrom fastmcp import FastMCPprint(MCP fastMCP server dependencies imported successfully!)MCP fastMCP server dependencies imported successfully!案例实现1. 实例化LlamaIndex工具使用API密钥实例化Notion工具规范。# Import and configure LlamaIndex Notion Tool Specfrom llama_index.tools.notion import NotionToolSpecnotion_token xxxxtool_spec NotionToolSpec(integration_tokennotion_token)2. 查看可用工具查看Notion工具规范中可用的工具。tools tool_spec.to_tool_list()for i, tool in enumerate(tools):print(fTool {i1}: {tool.metadata.name})Tool 1: load_data Tool 2: search_data3. 创建并配置FastMCP服务器创建FastMCP服务器并注册每个工具。mcp_server FastMCP(MCP Agent Tools Server)# Register the tools from the Notion ToolSpecfor tool in tools:mcp_server.tool(nametool.metadata.name,descriptiontool.metadata.description)(tool.real_fn)MCP Server configured with tools4. 运行MCP服务器运行MCP服务器使其可以通过HTTP协议访问。[06/27/25 16:27:47] INFO Starting MCP server MCP Agent Tools Server with transport streamable-http on http://127.0.0.1:8000/mcp/INFO: Started server process [24668]INFO: Waiting for application startup.INFO: Application startup complete.INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRLC to quit)INFO: 127.0.0.1:54201 - POST /mcp/ HTTP/1.1 200 OKINFO: 127.0.0.1:54201 - POST /mcp/ HTTP/1.1 202 AcceptedINFO: 127.0.0.1:54203 - GET /mcp/ HTTP/1.1 200 OKINFO: 127.0.0.1:54209 - POST /mcp/ HTTP/1.1 200 OKINFO: Shutting downERROR: ASGI callable returned without completing response.ERROR: Cancel 0 running task(s), timeout graceful shutdown exceededINFO: Waiting for application shutdown.INFO: Application shutdown complete.INFO: Finished server process [24668]案例效果本案例成功将LlamaIndex的Notion工具转换为MCP工具实现了以下效果将LlamaIndex代理工具如NotionToolSpec转换为MCP工具创建了一个名为MCP Agent Tools Server的FastMCP服务器成功注册了load_data和search_data两个工具到MCP服务器服务器通过streamable-http传输方式在http://127.0.0.1:8000/mcp/上运行服务器能够处理POST和GET请求返回适当的HTTP状态码其他应用程序可以通过MCP协议访问这些工具关键点这种转换使LlamaIndex中的丰富工具生态系统可以通过MCP协议被更广泛的应用程序访问大大扩展了这些工具的适用范围和互操作性。案例实现思路本案例的实现思路基于以下几个关键概念1工具抽象LlamaIndex中的工具规范如NotionToolSpec提供了一组标准化的工具接口这些工具可以被转换为其他协议格式。2MCP协议适配通过FastMCP服务器将LlamaIndex工具适配到MCP协议使它们可以通过标准化的MCP接口被访问。3动态工具注册通过遍历工具列表并动态注册到MCP服务器实现工具的自动转换和暴露。4HTTP传输使用streamable-http传输方式使MCP服务器可以通过HTTP协议被远程访问。扩展建议基于本案例可以考虑以下扩展方向多工具集成将多个LlamaIndex工具规范集成到同一个MCP服务器提供更丰富的功能自定义传输协议实现其他传输协议如WebSocket、gRPC等适应不同的应用场景工具分组与命名空间实现工具分组和命名空间机制便于管理和使用大量工具认证与授权添加认证和授权机制保护MCP服务器和工具访问工具元数据增强增强工具元数据提供更详细的工具描述、参数说明和使用示例工具版本管理实现工具版本管理机制支持工具的升级和兼容性处理性能监控添加性能监控和日志记录功能便于调试和优化工具链组合支持将多个工具组合成工具链实现更复杂的功能总结本案例展示了如何将LlamaIndex中的代理工具转换为MCP工具通过FastMCP服务器将这些工具暴露为MCP协议可访问的服务。这种转换方法简单直接只需几行代码就能完成大大扩展了LlamaIndex工具生态系统的适用范围。通过MCP协议LlamaIndex中的工具可以被更广泛的应用程序访问和使用提高了工具的互操作性和可重用性。这种方法为构建更加开放和互联的AI应用生态系统提供了基础。该案例的代码简洁明了易于理解和扩展为开发者提供了一个将LlamaIndex工具转换为MCP工具的标准模式。