112 lines
3.0 KiB
Markdown
112 lines
3.0 KiB
Markdown
# 🚀 Funstat MCP 快速参考
|
||
|
||
## 📍 关键文件位置
|
||
|
||
| 文件 | 路径 |
|
||
|------|------|
|
||
| **MCP 服务器** | `/Users/lucas/chat--1003255561049/funstat_mcp/server.py` |
|
||
| **Session 文件** | `~/telegram_sessions/funstat_bot.session` |
|
||
| **AgentAPI 配置** | `/Users/lucas/牛马/config.json` |
|
||
| **测试客户端** | `/Users/lucas/chat--1003255561049/test_mcp_client.py` |
|
||
| **重启指南** | `/Users/lucas/chat--1003255561049/RESTART_AGENTAPI_GUIDE.md` |
|
||
| **完整报告** | `/Users/lucas/chat--1003255561049/FUNSTAT_MCP_DEPLOYMENT_REPORT.md` |
|
||
|
||
---
|
||
|
||
## ⚡ 快速命令
|
||
|
||
### 测试 Funstat MCP（立即可用）
|
||
```bash
|
||
python3 /Users/lucas/chat--1003255561049/test_mcp_client.py
|
||
```
|
||
|
||
### 重启 AgentAPI
|
||
```bash
|
||
# 停止
|
||
pkill -f "agentapi mcp"
|
||
|
||
# 启动
|
||
cd /Users/lucas/牛马 && ./agentapi mcp -c config.json
|
||
```
|
||
|
||
### 检查配置
|
||
```bash
|
||
# 查看 funstat 配置
|
||
cat /Users/lucas/牛马/config.json | grep -A 5 "funstat"
|
||
|
||
# 验证 JSON 格式
|
||
python3 -m json.tool /Users/lucas/牛马/config.json > /dev/null && echo "✅" || echo "❌"
|
||
```
|
||
|
||
---
|
||
|
||
## 🎯 8个 Funstat MCP 工具
|
||
|
||
| 工具 | 命令 | 功能 | 测试状态 |
|
||
|------|------|------|---------|
|
||
| funstat_start | `/start` | 欢迎消息 | ✅ 成功 |
|
||
| funstat_search | `/search <关键词>` | 搜索群组/频道 | ✅ 成功 |
|
||
| funstat_topchat | `/topchat` | 热门聊天 | ✅ 成功 |
|
||
| funstat_menu | `/menu` | 显示菜单 | ✅ 成功 |
|
||
| funstat_balance | `/余额` | 查询积分 | ⚠️ 需调整 |
|
||
| funstat_text | `/text <文本>` | 文本搜索 | ⏳ 未测试 |
|
||
| funstat_human | `/human <姓名>` | 姓名搜索 | ⏳ 未测试 |
|
||
| funstat_user_info | `@username` | 用户详情 | ⏳ 未测试 |
|
||
|
||
---
|
||
|
||
## 📊 项目状态
|
||
|
||
### ✅ 已完成
|
||
- 完整的 MCP 服务器实现（8个工具）
|
||
- Session 文件创建和安全管理
|
||
- AgentAPI 配置添加
|
||
- 速率限制（18 req/s）和缓存（1小时）
|
||
- 独立测试客户端
|
||
- 完整文档和指南
|
||
- Docker 部署方案
|
||
|
||
### 🎯 核心测试结果
|
||
- ✅ Telegram 连接正常
|
||
- ✅ BOT 通信正常（@openaiw_bot）
|
||
- ✅ 5个工具测试通过
|
||
- ✅ 独立运行验证成功
|
||
|
||
### ⏳ 待确认
|
||
- AgentAPI 是否能识别并加载 funstat 配置
|
||
- 需要重启 AgentAPI 后验证
|
||
|
||
---
|
||
|
||
## 🔧 故障排查一行命令
|
||
|
||
```bash
|
||
# 全面检查
|
||
echo "Session:" && ls -lh ~/telegram_sessions/funstat_bot.session && \
|
||
echo "\nConfig:" && cat /Users/lucas/牛马/config.json | grep -A 3 "funstat" && \
|
||
echo "\nMCP Test:" && python3 /Users/lucas/chat--1003255561049/test_mcp_client.py
|
||
```
|
||
|
||
---
|
||
|
||
## 📞 联系信息
|
||
|
||
- **项目目录**: `/Users/lucas/chat--1003255561049/`
|
||
- **AgentAPI 目录**: `/Users/lucas/牛马/`
|
||
- **BOT**: @openaiw_bot (KT超级数据)
|
||
- **账号**: @xiaobai_80 (ID: 7363537082)
|
||
|
||
---
|
||
|
||
## 🎓 技术栈
|
||
|
||
- **Telethon**: Telegram MTProto 客户端
|
||
- **MCP**: Model Context Protocol
|
||
- **Python 3**: 异步编程（asyncio）
|
||
- **AgentAPI**: 自定义 MCP 服务器管理器
|
||
|
||
---
|
||
|
||
**最后更新**: 2025-10-26 20:58
|
||
**状态**: ✅ 配置完成，等待重启验证
|