Skip to content

W87878/advanced_mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📄 MCP Meeting Summary System

此專案結合前端與後端,實現一套基於 AI 與多工具協同的會議摘要及問答系統。 前端搭配 React + Tailwind UI,後端使用 FastAPI + MCP 架構,支援串接 OpenAI 與 Selenium 自動生成會議摘要,提供高品質 Markdown 報告。


🛠 專案結構

.
📁 api/
  ├── main.py              # FastAPI 入口點 + MCPClient
  ├── mcp_server.py        # MCP 工具伺服器 (summarize_meeting add multiply等工具)
  ├── article_generator.py # Selenium + OpenAI 摘要核心邏輯
📁 frontend/
  └── src/
      ├── components/ # 前端元件
      │   └── ui/   # UI 元件
      │       - button.tsx # 按鈕元件
      │       - textarea.tsx # 文本輸入元件
      │       - card.tsx # 卡片元件
      ├── frontend.tsx  # 主要入口與介面元件
      ├── main.tsx    # 前端入口點
      ├── vite.config.ts # Vite 配置(含別名設定)
      └── tailwind.config.js # Tailwind CSS 設定
📁 api/utils/
  └── logger.py  # 日誌紀錄工具
├── transcripts/           # 儲存逐字稿與 Markdown 摘要
├── api/.env               # 儲存 OpenAI API Key(已被 .gitignore 忽略)
├── pyproject.toml         # Python 專案設定檔   
├── README.md              # 本說明文件

🧑‍💻 安裝方式(建議使用 uv

# 安裝依賴(建議使用 uv)
uv pip install -r pyproject.toml
# 或使用 install 命令
uv pip install .
# 或使用 requirements.txt(如果你有產生的話)
uv pip install -r requirements.txt

後端 (backend)

✅ 啟動 MCP 工具伺服器 - MODE 預設為 streamable-http

cd api
uv run ./mcp_server.py

確保該檔案有註冊 @mcp.tool("summarize_meeting") 等功能,並支援 streamable-http, sse, stdio。

✅ 啟動 MCP Agent 問答介面

cd api
uv run ./main.py

前端 (frontend)

- 使用 React + Vite 快速開發
- Tailwind CSS 設計 UI,包含 Button、Textarea、Card 等自訂元件
- Framer Motion 實現平滑動畫與互動體驗
- 功能:輸入問題或逐字稿,呼叫後端 API,顯示智能摘要或回答,並用打字機效果呈現結果

啟動方式

cd front
npm install
npm run dev

預設會在 http://localhost:5173 啟動開發伺服器。

API 文件

欄位 型別 說明
query string 使用者輸入內容,如逐字稿
POST http://localhost:8001/query
{
  "query": "請幫我分析這份逐字稿內容..."
}

回傳

{
  "answer": "技術討論要點\n- ..."
}

🧙‍♂️ 功能特色

  • 🧠 多步推理 Agent:透過 GPT 工具選擇功能,自動呼叫 summarize_meeting 工具。
  • 🕸 Selenium 操作 Notebook LM:用真實瀏覽器生成摘要。
  • 📝 OpenAI Markdown 重整摘要:轉為結構化會議紀錄。
  • 📦 支援 HTTP / SSE / Stdio 模式 MCP Client

🔐 .env 設定

建立 .env 檔案,內容如下:

OPENAI_API_KEY=your_key_here
MCP_MODE=streamable-http, sse, stdio
MAX_ITERATIONS=your_max_iterations_here
MAX_TOKENS=your_max_tokens_here
TEMPERATURE=your_temperature_here
REQUEST_TIMEOUT=your_timeout_here
MODEL=your_model_here
USER_DATA_DIR=your_data_dir_here
PROFILE_DIRECTORY=your_profile_directory_here
DIR=your_directory_here
MAX_INPUT_LENGTH=your_max_length_here

或直接在 CLI 中執行:

export OPENAI_API_KEY=your_key_here
export MCP_MODE=streamable-http, sse, stdio
export MAX_ITERATIONS=your_max_iterations_here
export MAX_TOKENS=your_max_tokens_here
export TEMPERATURE=your_temperature_here
export REQUEST_TIMEOUT=your_timeout_here
export MODEL=your_model_here
export USER_DATA_DIR=your_data_dir_here
export PROFILE_DIRECTORY=your_profile_directory_here
export DIR=your_directory_here
export MAX_INPUT_LENGTH=your_max_length_here

📎 TODO / 延伸規劃

  • 整合新聞、論文與部落格自動爬取模組
  • 支援一鍵生成分析摘要與可視化報表
  • MCP 工具可串接更多分析模組(如 trend 分析、風險評估)

📜 License

MIT License

聯絡作者

Steve Wang | 2025

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published