内容
# 智能代理工具包 — 企业智能代理的MCP服务器
[](https://www.gnu.org/licenses/agpl-3.0)
[](https://github.com/Yacine-ai-tech/AgentKit/actions/workflows/ci.yml) [](LICENSE)
将企业关键绩效指标、健康评分、预测和异常检测作为工具、资源和提示模板公开，供任何MCP兼容的代理（如Claude Desktop、Cursor、LangGraph、Claude Agent SDK、CrewAI）使用。
> 🔗 **实时MCP服务器（SSE）：** https://agentkit.ysiddo-ai-projects.app/sse — 通过`mcp-remote`从Claude Desktop连接（参见[claude_desktop_config.example.json](claude_desktop_config.example.json)）。按需后端（首次调用约30–60秒）。
> 自主托管：参见[SELF_HOSTING.md](SELF_HOSTING.md)。
## 功能概述
- **6个MCP工具**: `query_kpis`, `get_company_health`, `detect_kpi_anomalies`, `forecast_metric`, `list_available_metrics`, `get_executive_summary`
- **6个MCP资源**: `kpi://Finance/latest` 和类似的Growth、Operations、People、ESG、IT_Ops资源
- **1个可重复使用的提示**: `monthly_executive_briefing`
- **LangGraph 3代理工作流** 在`workflow.py`中
- **Claude Agent SDK演示** 在`demos/claude_agent_sdk_demo.py`中
- **CrewAI演示** 在`demos/crewai_demo.py`中
- **DSPy研究框架** 在`research/dspy_experiment.py`中
## 快速开始
```bash
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env # 填写密钥 + POSTGRES_URL
python mcp_server.py
```
## Claude Desktop设置
添加到 `~/.config/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"agentkit": {
"command": "python",
"args": ["/abs/path/to/agentkit/mcp_server.py"],
"env": {
"POSTGRES_URL": "postgresql://...",
"ANTHROPIC_API_KEY": "sk-ant-...",
"GROQ_API_KEY": "gsk_...",
"OPENAI_API_KEY": "sk-...",
"LLM_DEFAULT": "groq/llama-3.3-70b-versatile",
"LLM_REASONING": "anthropic/claude-sonnet-4-6",
"LLM_JUDGE": "anthropic/claude-haiku-4-5",
"LLM_LOCAL": "ollama/llama3.3",
"LOG_LEVEL": "DEBUG",
"TELEMETRY_OPT_OUT": "true"
}
}
}
}
```
### 利用完整平台功能
AgentKit高度可配置。确保您不会因省略关键环境变量而低估其功能：
- **LLM路由/覆盖**: 使用`LLM_DEFAULT`、`LLM_REASONING`、`LLM_JUDGE`和`LLM_LOCAL`精确路由不同任务到最合适的模型，确保您获得速度和成本的最佳平衡。
- **提供商支持**: 除了Anthropic和Groq外，还原生支持OpenAI (`OPENAI_API_KEY`) 和Ollama。
- **诊断**: 您可以将`LOG_LEVEL`调整为`DEBUG`，以获得对编排引擎的更深入了解。
- **遥测**: 平台会自动发送匿名遥测数据，但您可以灵活地禁用它，方法是将`TELEMETRY_OPT_OUT=true`设置为true。
重启Claude Desktop，然后询问：
- "我们的公司健康状况如何？"
- "预测未来6个月的收入。"
- "Finance KPI是否存在异常？"
## LangGraph工作流
```python
from workflow import analyze
result = analyze("是什么驱动了Q1的毛利率？")
print(result["report"])
```
## 架构
```
Claude Desktop / Cursor / LangGraph
│
▼ MCP
┌──────────────────┐
│ mcp_server.py │
│ 6个工具 │
│ 6个资源 │
│ 1个提示 │
└────────┬─────────┘
│
┌──────────────┼──────────────┐
▼ ▼ ▼
pg_store insights forecasting
(KPIs) (health, (LinearReg
anomalies) + Monte Carlo)
```
## 许可证
MIT
## ⚖️ 许可证与企业使用（双重许可）
该项目在 **AGPL-3.0 许可证** 下开源。研究人员、学生和开源爱好者完全免费使用。
> **商业使用：** AGPLv3许可证要求任何使用或修改此代码的专有网络服务（SaaS、内部企业工具）也必须开源其整个后端。
>
> 如果您希望在闭源商业环境中使用此框架，或者需要 **企业功能** （SSO、Active Directory、Custom VPC Deployment、Strict RBAC），则必须获得 **商业许可证**。
> 请联系我们讨论商业许可和集成咨询。
## 📡 匿名遥测
该项目收集匿名、符合GDPR的启动信息，以帮助作者了解使用量并优先进行开发。
* **收集内容：** 仅收集项目名称和“启动”事件时间戳。无PII，无API密钥，无用户数据。
* **禁用方法：** 我们尊重您的隐私。要退出，只需在`.env`文件中设置`TELEMETRY_OPT_OUT=true`。
<!-- Scarf Analytics Pixel -->
<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=5f5bf922-eb01-4e07-a540-23c68e6752cc" />
## 许可
该项目根据 [AGPL-3.0 许可证](LICENSE)授权。
**商业使用：** 如果您希望在不发布自己的源代码的情况下商业使用此软件，请参见 [COMMERCIAL.md](COMMERCIAL.md) 以获取商业许可证。
**遥测：** 参见 [TELEMETRY.md](TELEMETRY.md) 以了解我们的隐私优先的数据实践。
