导航¶
学习如何使用您自己的自定义工具扩展 ToolUniverse。本节提供创建、注册和向 ToolUniverse 生态系统贡献工具的综合指南。
What You’ll Learn¶
Local Tool Development: Create tools that run within ToolUniverse
⏱️ Async Tool Development: Handle long-running operations with AsyncPollingTool
Remote Tool Integration: Connect with external services and APIs
Community Contributions: Submit your tools to the ToolUniverse repository
Advanced Patterns: Best practices and advanced development techniques
快速开始¶
我想快速尝试创建一个工具： → Create Your First Tool - 5分钟教程，帮助您创建第一个工具
我想系统地学习工具开发： → 选择您的路径：
Local tools: Local Tools Tutorial - Python classes for API wrappers, data processing
Async tools: Creating Async Tools with AsyncPollingTool - Long-running operations with automatic polling
远程工具: 远程工具教程 - 用于微服务和高强度计算的MCP服务器
我想为社区贡献工具： → 选择您的工具类型：
本地工具：将本地工具贡献至 ToolUniverse - 提交 Python 工具（需要修改
__init__.py）远程工具: 将远程工具贡献给ToolUniverse - 提交MCP服务器（需要部署）
完整指南：Contributing to ToolUniverse - 包含代码示例的完整贡献指南
I want to understand the differences: → 参考文档 - Compare tool types and usage scenarios
Tool Types Overview¶
本地工具¶
本地工具是在与 ToolUniverse 相同进程中运行的 Python 类。它们提供：
高性能：无网络开销
易于开发：简单的 Python 类
自动发现：工具使用装饰器自动注册
完全集成：访问所有 ToolUniverse 功能
Best for: - API wrappers and data processing - File manipulation utilities - Lightweight computational tools
关键点：贡献本地工具需要在 4 个特定位置修改 __init__.py 文件。
远程工具¶
远程工具允许您集成外部服务、API 或在不同服务器上运行的工具。它们提供：
可扩展性：将繁重计算卸载到专用服务器
集成：与现有系统和服务连接
灵活性：使用不同编程语言的工具
隔离：保持敏感操作分离
最适合： - 外部 API 集成 - 微服务连接 - 基于云的 AI 服务 - 专有系统连接
关键点：贡献远程工具需要提供一个公开可访问的服务器或详细的部署文档。
开发工作流程¶
Plan Your Tool
Define functionality and requirements
Choose between local or remote implementation
Design API and parameter structure
Develop Your Tool
Implement core functionality
Add proper error handling
Write comprehensive tests
Document Your Tool
Create clear documentation
Provide usage examples
Document all parameters and outputs
Test Thoroughly
Unit tests for all functionality
Integration tests with ToolUniverse
Test edge cases and error conditions
Submit for Review (if contributing)
Follow contribution guidelines
Create pull request
Address review feedback
示例¶
有关详细示例和代码样本，请参见：
Local Tools: Local Tools Tutorial - Complete examples with step-by-step instructions
Remote Tools: 远程工具教程 - MCP integration and API examples
Quick Start: Create Your First Tool - Simple 5-minute example to get started
获取帮助¶
如果您需要工具开发的帮助：
文档：查看特定指南以获取详细信息
示例：查看代码库中的现有工具
社区：在 GitHub 讨论区提问
问题：报告错误或请求功能
下一步措施¶
准备开始？请选择您的路径：
Quick Start: Create Your First Tool - Create your first tool in 5 minutes
Local Tools: Local Tools Tutorial - Learn local tool development
Remote Tools: 远程工具教程 - Learn remote tool integration
Contributing: Contributing to ToolUniverse - Submit tools to the community
Understanding: Review the tool type comparison table in Contributing to ToolUniverse
小技巧
Getting Started: We recommend starting with the quick start tutorial to understand the basics, then choosing the appropriate detailed guide based on your needs. The community is here to help you succeed!