mcp-chatbot

mcp-chatbot

一个模块化、异步研究助手，结合了 Anthropic Claude 3 与 模型上下文协议 (MCP)，为学术界和工程师提供按需文献搜索和总结功能。

---

1. 项目结构

mcp-chatbot/
├── Dockerfile
├── pyproject.toml
├── uv.lock
├── README.md
├── server_config.json
├── research_server.py
├── papers/                  # Cached paper metadata by topic
├── mcp_chatbot/
│   ├── __init__.py
│   ├── cli.py               # Typer-based CLI
│   └── core.py              # Main chatbot engine
└── tests/
    └── test_core.py

2. 快速开始

2.1. 克隆仓库

git clone https://github.com/mctrinh/mcp-chatbot.git
cd mcp-chatbot

2.2. 安装依赖

安装 uv（推荐）

# Git Bash or WSL on Windows, doesn't work in standard Command Prompt or PowerShell
curl -LsSf https://astral.sh/uv/install.sh | sh

# Scoop (Windows)
scoop install uv

# Chocolatey (Windows - Administrator Command Prompt - Recommended)
choco install uv
uv --version

安装 pyproject.toml 中 project.dependencies 的 Python 包

pip install -e .

3. 使用 Docker 构建和运行

# Build image
docker build -t mcp-chatbot:0.1 .

# Run server and CLI (ports 8001 and 8000)
docker run --rm -it -p 8001:8001 -p 8000:8000 mcp-chatbot:0.1

4. 本地开发运行（不使用 Docker）

# Install dependencies
uv pip install -e .[dev]

# Start the research server (MCP tool)
python research_server.py

# In a new terminal, launch the chatbot CLI
mcp-chatbot run

5. 尝试聊天机器人

5.1. REPL 模式

python -m mcp_chatbot.cli run

或使用已安装的脚本：

mcp-chatbot run

进入 REPL（读取-求值-打印循环）后，你可以直接输入命令或查询与聊天机器人交互。示例命令：

/prompts            # list Claude prompts
@folders            # list downloaded paper topics
AI alignment        # ask anything – Claude decide whether to invoke tools

5.2. 一次性查询

mcp-chatbot once "What are the latest trends in diffusion models?"

6. 配置（可选）

环境变量和 server_config.json 控制模型和端口：

export ANTHROPIC_MODEL="claude-3-opus-20240229"
export RESEARCH_PORT=8001
export PAPER_DIR=./papers

7. 测试

# Installs pytest, coverage, etc.
uv pip install -e .[dev]

# Run unit tests
pytest -q

# With coverage (optional)
pytest --cov=mcp_chatbot

8. 路线图

• 包含 search_papers 和 extract_info 的研究 MCP 服务（已完成）

• 通过 Claude 3 的工具使用（已完成）

• 提示词编排（已完成）

• 对存储论文的向量搜索（Faiss / Chroma）

• 使用 FastAPI + React 的网页 UI

• 用于 CI/CD 的 GitHub Actions

9. 许可证

MIT 许可证。版权所有 © 2025。

10. 当前问题

运行 mcp-chatbot run 时出现问题

• ⚠ 无法连接到服务器 'fetch'：方法未找到
• ⚠ 无法连接到服务器 'filesystem'：方法未找到