← 返回目录

Upsonic

社区

框架 / SDK

用 Python 构建自主 AI 智能体

这是用于开发 MCP Server 或 Agent 的框架，不是可以直接连接到客户端的 Server。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 394 / 438
Stars: ★ 8.0k 非常热门
运行环境: Python
凭据: 无需凭据
许可证: MIT
最近提交: 4 个月前

34FMRS · D

资料显示 Upsonic 是 MIT 许可的 Python AI 智能体框架，而不是已被清晰定义的 MCP 服务器。README 仅说明可集成 MCP 工具；未提供服务器清单、工具、传输、认证或客户端配置证据。

最强项 · 文档质量 9/20 最弱项 · 可靠性 4/20

可靠性

4/20

安全与权限

7/20

维护活跃度

9/20

文档质量

9/20

安装易用性

5/20

查看各项评分依据

可靠性 4/20: 仅提供 README，未提供服务器清单、实现代码、MCP 初始化或工具列表，也没有可核查的 CI 和测试证据。README 仅泛称支持 MCP 工具，因此启动、握手、工具一致性和错误处理均无法验证，按静态审查保守扣分。
安全与权限 7/20: README 声称文件和 shell 操作限制在 workspace 内，并阻止路径遍历和危险命令；但未提供实现、权限模型、凭据处理、网络数据流或危险操作确认的证据。自主代理及外部模型/服务可能产生副作用，因此仅给予部分分数。
维护活跃度 9/20: 仓库未归档，声明使用 MIT 许可证，并提供 GitHub issue、文档、Discord、变更日志和贡献入口。这些信息表明存在维护与支持渠道；但未给出提交历史、发布频率、依赖更新、安全响应流程或所有者责任证据，因此扣分。
文档质量 9/20: README 提供安装命令、Python 快速示例、OCR 示例、文档/API/示例链接和社区支持入口。缺少 MCP 服务器配置、工具参数与限制、认证、成本、故障排查和可复核的服务器行为说明，因此无法接近满分。
安装易用性 5/20: 提供 Python 包安装命令和普通代理示例，但没有 MCP server manifest、启动命令、传输方式、主流客户端配置或从安装到连接的步骤。MCP 仅以集成方向被提及，实际连接流程不可验证，因此分数较低。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么写入 / 删除本地文件执行命令或代码访问网络

适合谁

希望使用 Python 开发 AI 智能体的开发者
需要工作区范围文件和 shell 操作的自主智能体项目
需要自定义工具或 OCR 能力的项目

不适合谁

需要现成 MCP 服务器工具清单的用户
需要已验证传输方式、认证方式或客户端配置的用户
希望在未提供隔离环境时运行不受限制的文件或 shell 操作的项目

所需权限

自主智能体的文件和 shell 操作被限制在指定 workspace 内
README 未说明 MCP 服务器所需的额外权限、认证或外部服务访问权限

风险与副作用

自主智能体涉及文件和 shell 操作，即使 README 声明会阻止路径遍历和危险命令，仍应审查 workspace 范围
连接沙箱提供商属于后续配置，README 仅举例提到 E2B，未说明具体安全设置
该资料未证明仓库本身提供可直接连接的 MCP 服务器

安装接入

准备工作

运行环境：Python

README 提供的 Python 包安装方式为 uv pip install upsonic 或 pip install upsonic。该资料未提供 MCP 服务器安装或客户端配置步骤。

验证是否装好

运行 `uv pip install upsonic` 后执行 `from upsonic import Agent, Task` 并运行 agent.print_do(task)，若能正常返回结果即安装成功。

常见排障

确认已安装 `upsonic` Python 包
检查指定 workspace 路径是否正确且可访问
查看 Upsonic 文档、快速入门和示例
若需要 MCP 集成，确认所使用的具体 MCP 工具及其配置来源

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 Upsonic 创建一个 AutonomousAgent 分析服务器日志中的异常模式
写一个使用 @tool 装饰器定义 sum_tool 的 Upsonic 传统 Agent 示例
使用 EasyOCREngine 从 invoice.pdf 提取文本

使用场景

构建自主 AI 智能体

构建传统智能体系统

添加自定义工具

使用 MCP 工具连接外部数据源和服务

OCR 与文档处理

详细介绍

Upsonic 是一个用于用 Python 构建自主 AI 智能体和传统智能体系统的框架。README 提到可集成 MCP 工具，但未提供该仓库作为 MCP 服务器的清单、工具定义、传输方式或客户端配置。