285 lines
5.8 KiB
Markdown
285 lines
5.8 KiB
Markdown
# 🔄 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*
|