followin-mcp

一个面向 crypto 场景的 Followin MCP 原型，当前重点是：

• 内容归一化

• 事件聚类

• 用户个性化推荐排序

• 推荐解释与调试

目录结构

• followin_mcp/ Python 包入口

• followin_mcp/core/ 核心业务逻辑：adapter、model、normalizer、ranking、service

• followin_mcp/mcp/ MCP server 入口

• followin_mcp/demo/ 测试 agent 和 Web demo

• scripts/debug_recommendation.py 推荐调试脚本

• scripts/start_dev.sh 本地一键启动脚本

• web/ 前端静态资源

核心模块

• followin_mcp/core/adapters.py Followin API 适配层

• followin_mcp/core/models.py 数据模型

• followin_mcp/core/normalizer.py 原始内容标准化、实体抽取、事件类型识别

• followin_mcp/core/clustering.py 事件聚类

• followin_mcp/core/ranking.py 用户推荐排序与解释

• followin_mcp/core/digest.py 简报生成

• followin_mcp/core/service.py 面向 MCP / 应用层的服务入口

运行调试脚本

python3 scripts/debug_recommendation.py

Web Demo

如果你想更直观地测试“随机用户画像 + 多轮对话”，可以启动一个 Web demo：

python3 -m followin_mcp.demo.webapp

或者安装后：

followin-mcp-web

然后打开：

http://127.0.0.1:8000

这个 demo 支持：

• 随机生成用户画像

• 为当前画像创建一个 LangChain agent session

• 在同一个 session 里保留多轮聊天上下文

• 展示每轮实际发生的一个或多个 tool 调用

• 展示 tool 参数和返回结果卡片

运行前请确保 .env 中已经配置：

FOLLOWIN_API_KEY=your_api_key
OPENAI_API_KEY=your_openai_api_key

MCP Server

当前已经把以下能力暴露成 MCP tools：

• get_latest_headlines

• get_trending_feeds

• get_project_feed

• get_project_opinions

• get_trending_topics

• search_content

启动方式：

python3 -m followin_mcp.mcp.server

或者安装后使用：

followin-mcp-server