funstat-mcp/docs/RESTART_AGENTAPI_GUIDE.md

# 🔄 重启 AgentAPI 系统指南

## ✅ 已完成的配置

### 1. Funstat 配置已添加

已成功将 funstat 配置添加到 `/Users/lucas/牛马/config.json`:

```json
"funstat": {
  "api_id": 24660516,
  "api_hash": "eae564578880a59c9963916ff1bbbd3a",
  "session_path": "/Users/lucas/telegram_sessions/funstat_bot",
  "bot_username": "@openaiw_bot"
}
```

### 2. 文件验证

- ✅ JSON 格式正确
- ✅ Session 文件存在: `~/telegram_sessions/funstat_bot.session`
- ✅ MCP 服务器代码就绪: `/Users/lucas/chat--1003255561049/funstat_mcp/server.py`

---

## 📋 重启 AgentAPI 步骤

### 第1步: 停止当前 AgentAPI 进程

```bash
# 查找 agentapi mcp 进程
ps aux | grep "agentapi mcp" | grep -v grep

# 找到进程ID（PID），然后 kill
kill <PID>

# 或者直接使用 pkill
pkill -f "agentapi mcp"
```

### 第2步: 确认进程已停止

```bash
ps aux | grep "agentapi mcp" | grep -v grep
# 应该没有输出
```

### 第3步: 重新启动 AgentAPI MCP

```bash
cd /Users/lucas/牛马
./agentapi mcp -c config.json
```

或者后台运行：

```bash
cd /Users/lucas/牛马
nohup ./agentapi mcp -c config.json > log/agentapi-mcp.log 2>&1 &
```

### 第4步: 验证启动成功

```bash
# 检查进程
ps aux | grep "agentapi mcp" | grep -v grep

# 检查日志（如果使用 nohup）
tail -f /Users/lucas/牛马/log/agentapi-mcp.log
```

---

## 🧪 测试 Funstat MCP 工具

### 方法1: 在新的 Claude Code 会话中测试

1. 打开一个新的 Telegram 聊天或 Claude Code 会话
2. 尝试使用以下命令（如果 agentapi 已经集成了 funstat）:
   - 询问 "使用 funstat 搜索 Telegram"
   - 或直接调用工具

### 方法2: 使用 Python 测试客户端

```bash
cd /Users/lucas/chat--1003255561049
python3 test_mcp_client.py
```

这将直接测试 funstat MCP 服务器的所有功能。

---

## 📊 预期结果

### 如果 AgentAPI 成功集成 Funstat

重启后，你应该能看到：
- ✅ 新的 MCP 工具可用（带 `mcp__funstat__` 前缀）
- ✅ 8个 funstat 工具自动加载
- ✅ 可以在任何会话中使用

### 如果 AgentAPI 还未集成 Funstat

你可能会看到：
- ⚠️ 配置被读取，但没有新工具出现
- ⚠️ 需要查看 agentapi 的源代码来确认如何注册新的 MCP 服务器

在这种情况下，可以使用：
- **方案A**: 独立运行 funstat MCP 服务器
  ```bash
  cd /Users/lucas/chat--1003255561049/funstat_mcp
  python3 server.py
  ```

- **方案B**: 使用 Python 测试客户端
  ```bash
  python3 /Users/lucas/chat--1003255561049/test_mcp_client.py
  ```

---

## 🔍 检查点

### 配置文件检查

```bash
# 查看 funstat 配置
cat /Users/lucas/牛马/config.json | grep -A 5 "funstat"

# 验证 JSON 格式
python3 -m json.tool /Users/lucas/牛马/config.json > /dev/null && echo "✅ 正确" || echo "❌ 错误"
```

### Session 文件检查

```bash
# 检查 Session 文件
ls -lh ~/telegram_sessions/funstat_bot.session

# 检查权限（应该是 600）
stat -f "%Lp" ~/telegram_sessions/funstat_bot.session
```

### MCP 服务器检查

```bash
# 测试 MCP 服务器可以启动
cd /Users/lucas/chat--1003255561049/funstat_mcp
timeout 5 python3 server.py 2>&1 | head -20
```

---

## ⚠️ 故障排查

### 问题1: AgentAPI 无法启动

**症状**: 运行 `./agentapi mcp -c config.json` 后立即退出

**解决**:
1. 检查配置文件 JSON 格式
   ```bash
   python3 -m json.tool /Users/lucas/牛马/config.json
   ```

2. 查看错误日志
   ```bash
   ./agentapi mcp -c config.json 2>&1 | tee error.log
   ```

### 问题2: Funstat 工具未出现

**症状**: AgentAPI 正常运行，但看不到 funstat 工具

**原因**: AgentAPI 可能需要额外的代码来注册外部 MCP 服务器

**解决方案**:
- 使用独立的 funstat MCP 服务器
- 或者联系 agentapi 开发者了解如何注册新的 MCP 工具

### 问题3: Session 文件错误

**症状**: 提示 "Session 文件不存在" 或 "认证失败"

**解决**:
```bash
# 重新创建 Session 文件
cd /Users/lucas/chat--1003255561049
python3 create_session_safe.py
```

---

## 📞 如果需要帮助

### 信息收集

如果遇到问题，请收集以下信息：

```bash
# 1. AgentAPI 版本
/Users/lucas/牛马/agentapi --version

# 2. 进程状态
ps aux | grep agentapi

# 3. 配置文件（移除敏感信息后）
cat /Users/lucas/牛马/config.json

# 4. 错误日志
tail -50 /Users/lucas/牛马/log/agentapi-mcp.log

# 5. Funstat MCP 测试结果
python3 /Users/lucas/chat--1003255561049/test_mcp_client.py
```

---

## 🎯 总结

### 已完成
- ✅ Funstat 配置添加到 agentapi config.json
- ✅ JSON 格式验证通过
- ✅ Session 文件就绪
- ✅ MCP 服务器代码完整

### 下一步
1. **停止** 当前 agentapi 进程
2. **重启** agentapi with 新配置
3. **测试** funstat 工具是否可用
4. **反馈** 结果

---

**重要提示**:
- 重启后，请告诉我结果，这样我可以帮你进一步调试
- 如果 funstat 工具没有出现，我们可以使用备选方案
- 独立的 funstat MCP 服务器已经完全可以工作，这是保底方案

---

*文档创建时间: 2025-10-26*
*配置文件路径: /Users/lucas/牛马/config.json*
*项目路径: /Users/lucas/chat--1003255561049/*