doudou/funstat-mcp

Fork 0

Files

你的用户名 a05a7dd40e chore: initial commit

2025-11-01 21:58:03 +08:00

5.8 KiB

Raw Blame History

🔄 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: 命令行直接使用

# 启动 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

{
  "funstat": {
    "command": "/Users/lucas/牛马/agentapi",
    "args": ["proxy", "http://127.0.0.1:8091/sse"],
    "env": {}
  }
}

方法 3: 修改 AgentAPI 配置（推荐）

如果 agentapi 支持配置多个 MCP 服务器，可以在配置中添加：

文件: /Users/lucas/牛马/config.json

添加 MCP 服务器列表（如果支持）：

{
  "mcp_servers": {
    "funstat": {
      "type": "sse",
      "url": "http://127.0.0.1:8091/sse"
    }
  }
}

🧪 测试 Proxy 连接

测试 1: 手动运行 Proxy

# 在终端运行
/Users/lucas/牛马/agentapi proxy http://127.0.0.1:8091/sse

成功时应该看到：

✅ 连接到 SSE 服务器
✅ STDIO 代理已启动

测试 2: 使用 Python MCP 客户端

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)  │
└──────────────────┘

🚀 自动启动配置

创建启动脚本

#!/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 服务器未运行

检查:

ps aux | grep "python3 server.py"
lsof -i :8091

解决:

cd /Users/lucas/chat--1003255561049/funstat_mcp
./start_sse.sh

问题 2: Proxy 连接失败

检查:

curl -I http://127.0.0.1:8091/sse

应该返回 HTTP/1.1 200 OK

解决:

确保 SSE 服务器正在运行
检查防火墙设置
查看日志: tail -f funstat_sse.log

问题 3: Session 过期

症状: Telegram 连接失败

解决:

cd /Users/lucas/chat--1003255561049
python3 create_session_safe.py

📝 配置文件示例

claude-code-mcp-config.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

{
  "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 已重启

🎯 下一步

测试 Proxy 连接:

/Users/lucas/牛马/agentapi proxy http://127.0.0.1:8091/sse

更新配置文件 (根据需要选择上述方法之一)
重启 Claude Code 或 AgentAPI
验证工具可用性 - 应该能看到 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

5.8 KiB Raw Blame History Unescape Escape