doudou/funstat-mcp

Fork 0

Files

woshiqp465 d0ba2b188b feat: add postgres storage and remote sync

2025-11-07 16:59:28 +08:00

8.7 KiB

Raw Blame History

Codex CLI - Funstat MCP 配置指南

配置时间: 2025-10-27 状态: ✅ 已配置完成 Codex CLI 版本: 0.49.0

📋 配置概述

本指南说明如何在 Codex CLI (OpenAI 的命令行 AI 助手) 中配置 Funstat MCP 服务器,使 Codex 可以调用 Funstat 的翻页搜索功能。

✅ 已完成的配置

1. MCP 服务器添加 ✅

命令:

codex mcp add --url http://127.0.0.1:8094/sse funstat

输出:

Added global MCP server 'funstat'.

2. 配置验证 ✅

配置详情:

Name:      funstat
URL:       http://127.0.0.1:8094/sse
Transport: streamable_http
Status:    enabled
Auth:      Unsupported

3. 配置文件更新 ✅

文件位置: ~/.codex/config.toml

新增内容:

[mcp_servers.funstat]
url = "http://127.0.0.1:8094/sse"

🚀 使用方法

在 Codex CLI 中使用

# 启动 Codex 交互式会话
codex

# 在 Codex 中输入你的请求
> 帮我搜索所有包含"翻译"关键词的Telegram用户,并自动翻页获取完整数据

Codex 会自动:

✅ 连接到 Funstat MCP 服务器
✅ 调用 search_users 工具
✅ 使用自动翻页功能
✅ 返回完整的搜索结果

🛠️ MCP 服务器管理

列出所有 MCP 服务器

codex mcp list

输出:

Name     Url                        Bearer Token Env Var  Status   Auth
funstat  http://127.0.0.1:8094/sse  -                     enabled  Unsupported

查看服务器详情

codex mcp get funstat

输出:

funstat
  enabled: true
  transport: streamable_http
  url: http://127.0.0.1:8094/sse
  bearer_token_env_var: -
  http_headers: -
  env_http_headers: -
  remove: codex mcp remove funstat

删除 MCP 服务器

codex mcp remove funstat

重新添加

codex mcp add --url http://127.0.0.1:8094/sse funstat

🔧 SSE 服务器管理

确保 SSE 服务器运行

检查状态:

ps aux | grep server.py | grep -v grep

如果未运行,启动服务器:

cd /Users/lucas/chat--1003255561049/funstat_mcp
nohup python3 server.py > /tmp/funstat_sse.log 2>&1 &

查看日志:

tail -f /tmp/funstat_sse.log

🎯 可用的 MCP 工具

Codex 可以调用以下 Funstat MCP 工具:

工具名	功能	示例提示
`search_users`	搜索用户/群组	"搜索翻译相关用户"
`send_command`	发送命令到 BOT	"发送 /search subtitle"
`get_user_info`	获取用户详情	"查询用户 @username"
`get_group_info`	获取群组详情	"查询群组 123456"
`get_message_stats`	消息统计	"获取消息统计"
`list_recent_chats`	最近对话列表	"列出最近对话"
`get_help`	获取帮助	"显示 Funstat 帮助"
`get_status`	服务器状态	"检查服务器状态"

📖 使用示例

示例 1: 交互式搜索

$ codex

Codex> 请帮我搜索包含"翻译"的Telegram用户,并自动翻页获取所有结果

[Codex 调用 Funstat MCP 的 search_users 工具]
[自动翻页,获取完整数据]
[返回结果: 890条记录,包括ID、用户名、来源页码]

示例 2: 一次性命令

codex exec "搜索所有包含'subtitle'关键词的Telegram群组"

示例 3: 带图片的搜索

codex -i screenshot.png "这个截图中的Telegram用户名是什么?帮我搜索相关信息"

📊 架构图

┌─────────────────────────────────────────────┐
│           Codex CLI (命令行)                 │
│   codex / codex exec                        │
└─────────────────┬───────────────────────────┘
                  │
                  │ 读取配置
                  │ ~/.codex/config.toml
                  │
    ┌─────────────▼──────────────┐
    │    MCP Client (Codex内置)   │
    │  [mcp_servers.funstat]     │
    │  url = http://...          │
    └─────────────┬──────────────┘
                  │
                  │ SSE 连接
                  │ http://127.0.0.1:8094/sse
                  │
    ┌─────────────▼──────────────────┐
    │  Funstat MCP Server (SSE)      │
    │  funstat_mcp/server.py         │
    │  端口: 8094                     │
    └─────────────┬──────────────────┘
                  │
                  │ Telethon
                  │ (Telegram MTProto)
                  │
    ┌─────────────▼──────────────┐
    │   Telegram BOT             │
    │   @openaiw_bot             │
    │   (KT超级数据)              │
    └────────────────────────────┘

🔧 高级配置

添加环境变量认证 (可选)

如果需要 Bearer Token 认证:

# 设置环境变量
export FUNSTAT_TOKEN="your-token-here"

# 添加 MCP 服务器时指定
codex mcp add \
  --url http://127.0.0.1:8094/sse \
  --bearer-token-env-var FUNSTAT_TOKEN \
  funstat

手动编辑配置文件

文件: ~/.codex/config.toml

[mcp_servers.funstat]
url = "http://127.0.0.1:8094/sse"
# bearer_token_env_var = "FUNSTAT_TOKEN"  # 可选

🐛 故障排除

问题 1: Codex 无法连接到 MCP 服务器

可能原因:

SSE 服务器未运行
URL 配置错误
端口被占用

解决方法:

# 1. 检查 SSE 服务器状态
ps aux | grep server.py

# 2. 测试 SSE 端点
curl -i http://127.0.0.1:8094/sse

# 3. 重启 SSE 服务器
cd /Users/lucas/chat--1003255561049/funstat_mcp
python3 server.py

# 4. 验证 MCP 配置
codex mcp get funstat

问题 2: MCP 工具不可用

可能原因:

MCP 服务器未启用
Codex 版本过低

解决方法:

# 1. 检查 Codex 版本 (需要 0.40.0+)
codex --version

# 2. 更新 Codex
brew upgrade codex-cli

# 3. 验证 MCP 服务器状态
codex mcp list

问题 3: Session 文件锁定

解决方法:

# 停止所有使用 session 的进程
pkill -f server.py

# 重启 SSE 服务器
cd /Users/lucas/chat--1003255561049/funstat_mcp
python3 server.py

📖 相关文档

Codex CLI 文档

Funstat MCP 文档

README.md - 项目主文档
PAGINATION_SUCCESS_REPORT.md - 翻页功能
CURSOR_MCP_SETUP.md - Cursor IDE 配置
SSE_CONVERSION_COMPLETE.md - SSE 转换

🎊 配置完成!

✅ 当前状态

✅ Codex MCP 配置已添加
✅ 配置文件已更新 (~/.codex/config.toml)
✅ SSE 服务器运行中
✅ Funstat MCP 工具已可用

🚀 验证步骤

检查配置:
```
codex mcp list
```
启动 Codex:
```
codex
```

测试搜索:

Codex> 列出可用的 MCP 工具
Codex> 搜索包含"翻译"的Telegram用户

📝 快速命令

# 查看 MCP 服务器
codex mcp list

# 启动 Codex
codex

# 一次性命令
codex exec "搜索翻译相关用户"

# 检查 SSE 服务器
ps aux | grep server.py

💡 使用技巧

1. 组合多个工具

codex exec "先搜索'翻译'相关用户,然后查询前5个用户的详细信息"

2. 批量处理

codex exec "搜索以下关键词并汇总结果: 翻译, subtitle, fansub"

3. 导出结果

codex exec "搜索翻译用户并导出为JSON格式"

✨ 现在支持的 AI 工具

AI 工具	配置方式	配置文件	状态
Claude Code	项目配置	`claude-code-mcp-config.json`	✅
Cursor IDE	项目配置	`.cursor/mcp.json`	✅
Codex CLI	全局配置	`~/.codex/config.toml`	✅

配置完成时间: 2025-10-27 SSE 服务器: ✅ 运行中 Codex MCP: ✅ 已配置

🎉 Codex CLI 现在可以使用 Funstat MCP 工具了! 🎉

🎯 下一步

启动 Codex: codex
测试工具: 让 Codex 搜索 Telegram 用户
探索功能: 尝试不同的搜索关键词和翻页功能

提示: Codex 支持自然语言交互,你可以用中文或英文与它对话!

8.7 KiB Raw Blame History

Codex CLI - Funstat MCP 配置指南

📋 配置概述

✅ 已完成的配置

1. MCP 服务器添加 ✅

2. 配置验证 ✅

3. 配置文件更新 ✅

🚀 使用方法

在 Codex CLI 中使用

🛠️ MCP 服务器管理

列出所有 MCP 服务器

查看服务器详情

删除 MCP 服务器

重新添加

🔧 SSE 服务器管理

确保 SSE 服务器运行

🎯 可用的 MCP 工具

📖 使用示例

示例 1: 交互式搜索

示例 2: 一次性命令

示例 3: 带图片的搜索

📊 架构图

🔧 高级配置

添加环境变量认证 (可选)

手动编辑配置文件

🐛 故障排除

问题 1: Codex 无法连接到 MCP 服务器

问题 2: MCP 工具不可用

问题 3: Session 文件锁定

📖 相关文档

Codex CLI 文档

Funstat MCP 文档

🎊 配置完成!

✅ 当前状态

🚀 验证步骤

📝 快速命令

💡 使用技巧

1. 组合多个工具

2. 批量处理

3. 导出结果

✨ 现在支持的 AI 工具

🎯 下一步

8.7 KiB

Raw Blame History