chore: initial commit

docs/AGENTAPI_PROXY_SETUP.md

@@ -0,0 +1,284 @@
+# 🔄 AgentAPI Proxy 配置指南
+
+## ✅ SSE 服务器已启动
+
+**Funstat MCP SSE 服务器**：
+- ✅ 已成功转换为 SSE 模式
+- ✅ 运行中（PID: 83898）
+- 📡 SSE 端点: `http://127.0.0.1:8091/sse`
+- 📨 消息端点: `http://127.0.0.1:8091/messages`
+
+---
+
+## 🔌 使用 AgentAPI Proxy 连接
+
+### 方法 1: 命令行直接使用
+
+```bash
+# 启动 agentapi proxy，连接到 funstat SSE 服务器
+/Users/lucas/牛马/agentapi proxy http://127.0.0.1:8091/sse
+```
+
+这将创建一个 **STDIO ↔ SSE 代理**，Claude Code 可以通过标准输入输出与 funstat 通信。
+
+### 方法 2: 通过 claude-code-mcp-config.json 配置
+
+修改项目配置文件：
+
+**文件**: `/Users/lucas/chat--1003255561049/claude-code-mcp-config.json`
+
+```json
+{
+  "funstat": {
+    "command": "/Users/lucas/牛马/agentapi",
+    "args": ["proxy", "http://127.0.0.1:8091/sse"],
+    "env": {}
+  }
+}
+```
+
+### 方法 3: 修改 AgentAPI 配置（推荐）
+
+如果 agentapi 支持配置多个 MCP 服务器，可以在配置中添加：
+
+**文件**: `/Users/lucas/牛马/config.json`
+
+添加 MCP 服务器列表（如果支持）：
+
+```json
+{
+  "mcp_servers": {
+    "funstat": {
+      "type": "sse",
+      "url": "http://127.0.0.1:8091/sse"
+    }
+  }
+}
+```
+
+---
+
+## 🧪 测试 Proxy 连接
+
+### 测试 1: 手动运行 Proxy
+
+```bash
+# 在终端运行
+/Users/lucas/牛马/agentapi proxy http://127.0.0.1:8091/sse
+```
+
+成功时应该看到：
+```
+✅ 连接到 SSE 服务器
+✅ STDIO 代理已启动
+```
+
+### 测试 2: 使用 Python MCP 客户端
+
+```python
+import subprocess
+import json
+
+# 启动 proxy 作为子进程
+proxy = subprocess.Popen(
+    ['/Users/lucas/牛马/agentapi', 'proxy', 'http://127.0.0.1:8091/sse'],
+    stdin=subprocess.PIPE,
+    stdout=subprocess.PIPE,
+    stderr=subprocess.PIPE
+)
+
+# 发送 MCP 请求
+request = {
+    "jsonrpc": "2.0",
+    "id": 1,
+    "method": "tools/list",
+    "params": {}
+}
+
+proxy.stdin.write((json.dumps(request) + '\\n').encode())
+proxy.stdin.flush()
+
+# 读取响应
+response = proxy.stdout.readline()
+print(response.decode())
+```
+
+---
+
+## 📊 架构图
+
+```
+┌──────────────────┐
+│  Claude Code     │
+│  (STDIO 客户端)   │
+└────────┬─────────┘
+         │ STDIO (stdin/stdout)
+         ▼
+┌──────────────────┐
+│ agentapi proxy   │
+│  (STDIO ↔ SSE)   │
+└────────┬─────────┘
+         │ HTTP SSE
+         ▼
+┌──────────────────┐
+│ Funstat SSE      │
+│ MCP Server       │
+│ :8091            │
+└────────┬─────────┘
+         │ Telethon
+         ▼
+┌──────────────────┐
+│  @openaiw_bot    │
+│  (Telegram BOT)  │
+└──────────────────┘
+```
+
+---
+
+## 🚀 自动启动配置
+
+### 创建启动脚本
+
+```bash
+#!/bin/bash
+# start_funstat_mcp.sh
+
+# 1. 启动 SSE 服务器
+cd /Users/lucas/chat--1003255561049/funstat_mcp
+nohup python3 server.py > funstat_sse.log 2>&1 &
+SSE_PID=$!
+echo "✅ SSE 服务器已启动 (PID: $SSE_PID)"
+
+# 等待服务器就绪
+sleep 5
+
+# 2. 验证服务器
+curl -I http://127.0.0.1:8091/sse 2>&1 | grep "200 OK" && echo "✅ SSE 服务器响应正常" || echo "❌ SSE 服务器无响应"
+
+echo ""
+echo "📡 Funstat MCP SSE 已启动"
+echo "   SSE 端点: http://127.0.0.1:8091/sse"
+echo ""
+echo "🔗 通过 agentapi proxy 连接:"
+echo "   /Users/lucas/牛马/agentapi proxy http://127.0.0.1:8091/sse"
+```
+
+### 添加到系统启动（可选）
+
+使用 launchd 或 systemd 在系统启动时自动运行。
+
+---
+
+## 🔍 故障排查
+
+### 问题 1: SSE 服务器未运行
+
+**检查**:
+```bash
+ps aux | grep "python3 server.py"
+lsof -i :8091
+```
+
+**解决**:
+```bash
+cd /Users/lucas/chat--1003255561049/funstat_mcp
+./start_sse.sh
+```
+
+### 问题 2: Proxy 连接失败
+
+**检查**:
+```bash
+curl -I http://127.0.0.1:8091/sse
+```
+
+应该返回 `HTTP/1.1 200 OK`
+
+**解决**:
+- 确保 SSE 服务器正在运行
+- 检查防火墙设置
+- 查看日志: `tail -f funstat_sse.log`
+
+### 问题 3: Session 过期
+
+**症状**: Telegram 连接失败
+
+**解决**:
+```bash
+cd /Users/lucas/chat--1003255561049
+python3 create_session_safe.py
+```
+
+---
+
+## 📝 配置文件示例
+
+### claude-code-mcp-config.json（项目级）
+
+```json
+{
+  "funstat": {
+    "command": "/Users/lucas/牛马/agentapi",
+    "args": ["proxy", "http://127.0.0.1:8091/sse"],
+    "env": {}
+  }
+}
+```
+
+### Claude Desktop Config（全局）
+
+**文件**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "funstat": {
+      "command": "/Users/lucas/牛马/agentapi",
+      "args": ["proxy", "http://127.0.0.1:8091/sse"]
+    }
+  }
+}
+```
+
+---
+
+## ✅ 验证清单
+
+- [ ] SSE 服务器已启动（端口 8091）
+- [ ] SSE 端点响应正常（HTTP 200）
+- [ ] Telegram 连接正常
+- [ ] AgentAPI 已安装
+- [ ] Proxy 命令可执行
+- [ ] 配置文件已更新
+- [ ] Claude Code 已重启
+
+---
+
+## 🎯 下一步
+
+1. **测试 Proxy 连接**:
+   ```bash
+   /Users/lucas/牛马/agentapi proxy http://127.0.0.1:8091/sse
+   ```
+
+2. **更新配置文件** (根据需要选择上述方法之一)
+
+3. **重启 Claude Code** 或 AgentAPI
+
+4. **验证工具可用性** - 应该能看到 8 个 funstat 工具
+
+---
+
+## 📄 相关文件
+
+- SSE 服务器: `/Users/lucas/chat--1003255561049/funstat_mcp/server.py`
+- 启动脚本: `/Users/lucas/chat--1003255561049/funstat_mcp/start_sse.sh`
+- 日志文件: `/Users/lucas/chat--1003255561049/funstat_mcp/funstat_sse.log`
+- AgentAPI: `/Users/lucas/牛马/agentapi`
+- Session: `~/telegram_sessions/funstat_bot.session`
+
+---
+
+*文档创建时间: 2025-10-26 21:28*
+*SSE 服务器状态: ✅ 运行中*
+*端口: 8091*