# function_call

**Repository Path**: chztech/function_call

## Basic Information

- **Project Name**: function_call
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-24
- **Last Updated**: 2026-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Function Call Framework

<div align="center">

**一个完整的 Python Function Call 框架,方便 MCP 和 AI Agent 直接调用**

[![Python](https://img.shields.io/badge/Python-3.7+-blue.svg)](https://www.python.org/)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![Tests](https://img.shields.io/badge/Tests-Passing-brightgreen.svg)](tests/test_example.py)

</div>

---

## 🎯 快速开始

```python
from core import get_registry, get_executor
from tools import example_tools

executor = get_executor()
result = executor.execute("add", {"a": 10, "b": 20})
print(result)  # {'success': True, 'result': 30}
```

## 📚 文档导航

请访问 **[docs/INDEX.md](docs/INDEX.md)** 查看完整文档导航。

### 主要文档

- 📖 **[README.md](docs/README.md)** - 项目介绍和快速开始
- ⚡ **[QUICK_REFERENCE.md](docs/QUICK_REFERENCE.md)** - 5分钟快速上手
- 📚 **[USAGE_GUIDE.md](docs/USAGE_GUIDE.md)** - 详细使用指南
- 🏗️ **[PROJECT_STRUCTURE.md](docs/PROJECT_STRUCTURE.md)** - 项目结构说明
- 📊 **[SUMMARY.md](docs/SUMMARY.md)** - 项目总结

## 🏗️ 分层架构

```
function_call/
├── core/          # 核心框架层 (注册器 + 执行器)
├── adapters/      # 适配器层 (MCP + Agent)
├── tools/         # 工具函数层 (32个示例工具)
├── tests/         # 测试层
└── docs/          # 文档层
```

这种分层设计使代码更清晰、更易维护:
- **core/** - 核心业务逻辑,独立于任何协议
- **adapters/** - 协议适配,支持MCP和Agent
- **tools/** - 可插拔的工具函数集合
- **tests/** - 完整的测试用例
- **docs/** - 详细的文档体系

## ✨ 核心特性

- ✅ **自动Schema生成** - 从类型注解自动生成JSON Schema
- ✅ **装饰器注册** - 简单的 `@register` 装饰器
- ✅ **MCP兼容** - 完全兼容 Model Context Protocol
- ✅ **Agent友好** - 支持 LangChain、LlamaIndex 等
- ✅ **批量执行** - 支持批量函数调用
- ✅ **完善错误处理** - 参数验证 + 异常捕获
- ✅ **零依赖** - 仅使用Python标准库

## 🧪 运行测试

### 快速测试
```bash
python tests/test_example.py
```

### 完整测试套件
```bash
# 运行所有测试
python tests/run_all_tests.py

# 或分别运行
python tests/test_mcp.py      # MCP协议完整测试
python tests/test_agent.py    # Agent集成完整测试
```

所有测试通过 ✅

## 📦 安装

无需安装,直接使用Python标准库即可。

```bash
git clone <repository-url>
cd function_call
python tests/test_example.py
```

## 🎯 使用场景

1. **MCP服务器** - 为AI模型提供可调用的工具集
2. **AI Agent系统** - 构建具有工具调用能力的智能Agent
3. **插件系统** - 实现可扩展的插件架构
4. **API网关** - 统一管理多个函数的调用接口
5. **工作流引擎** - 编排和执行复杂的工作流

## 📊 项目统计

| 指标 | 数量 |
|------|------|
| 核心模块 | 4个 |
| 总代码行数 | ~830行 |
| 示例工具函数 | 32个 |
| 测试用例 | 5个 |
| 文档文件 | 7个 |
| 外部依赖 | 0个 |

## 🤝 贡献

欢迎提交Issue和Pull Request!

## 📄 许可证

MIT License

---

<div align="center">

**开始使用**: [docs/INDEX.md](docs/INDEX.md) | **快速参考**: [docs/QUICK_REFERENCE.md](docs/QUICK_REFERENCE.md)

Made with ❤️ using Python

</div>