mcp-chatbot

mcp-chatbot

Anthropic Claude 3 と Model Context Protocol (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（Read-Eval-Print Loop）内では、コマンドやクエリを入力してチャットボットと直接対話できます。コマンド例：

/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 を備えた Research MCP サーバー（完了）

• Claude 3 経由のツール使用（完了）

• プロンプトオーケストレーション（完了）

• 保存された論文に対するベクトル検索（Faiss / Chroma）

• FastAPI + React を使用した Web UI

• CI/CD 用の GitHub Actions

9. ライセンス

MIT License。Copyright © 2025。

10. 現在の問題

mcp-chatbot run を実行するときに発生する問題：

• ⚠ Could not connect to server 'fetch': Method not found
• ⚠ Could not connect to server 'filesystem': Method not found