Nerdearla Agenda MCP

🚀 Nerdearla議程 - MCP服務器

這是一個MCP（模型上下文協議）服務器，可提供對Nerdearla議程的即時訪問，遵循官方MCP架構。

🚀 快速開始

本MCP服務器用於即時獲取Nerdearla議程信息。你可以按照以下步驟進行安裝和使用：

安裝

# 若未安裝pnpm，可使用以下命令進行安裝
npm install -g pnpm

# 安裝項目依賴
pnpm install

運行

Transport STDIO（適用於Claude Desktop）

# 啟動適用於Claude Desktop的MCP服務器
node src/index.js

# 或者使用npm腳本啟動
pnpm start

Transport HTTP/SSE（適用於遠程連接）

# 啟動使用HTTP傳輸的MCP服務器
MCP_TRANSPORT=http node src/index.js

# 指定端口啟動
MCP_TRANSPORT=http PORT=8000 node src/index.js

# 或者使用npm腳本啟動
pnpm start:http

# 使用環境變量啟動
MCP_TRANSPORT=http MCP_PORT=8000 pnpm start

✨ 主要特性

項目背景

本MCP服務器是為Manuel Bruña和Carlos Pereyra在Nerdearla 2025上的演講 "Automatizá con flow: IA, n8n y MCP sin morir en el intento" 所開發的實踐演示。該演講展示瞭如何集成以下技術：

• 🤖 人工智能
• 🔗 n8n 用於工作流自動化
• ⚡ MCP（模型上下文協議） 用於連接人工智能與外部系統

你可以點擊此處觀看演講。

MCP架構實現

本項目正確實現了MCP架構，包含以下部分：

• 數據層：採用JSON - RPC 2.0協議進行客戶端 - 服務器通信。
• 傳輸層：支持STDIO（本地）和HTTP/SSE（遠程）。
• MCP原語：提供用於執行議程特定功能的工具。

功能（MCP工具）

可用工具

1. get_upcoming_talks - 根據GMT - 3獲取即將舉行的演講信息，若有可用URL會一併提供。
2. get_past_talks - 獲取已結束的演講信息，若有可用URL會一併提供。
3. get_topics_by_tags - 列出按標籤分組的可用主題。
4. get_next_talk - 獲取即將舉行的下一場演講信息，若有可用URL會一併提供。
5. get_missed_talks - 獲取已開始但你仍可能趕上的演講信息，若有可用URL會一併提供。
6. get_best_talk_recommendation - 提供關於活動中最精彩演講的專業推薦🎯。
7. get_cache_info - 獲取智能緩存系統的信息（緩存有效期為24小時）。

隱藏彩蛋

想知道Nerdearla最棒的演講是哪一場嗎？試試 get_best_talk_recommendation 工具，發現我們的特別推薦😉。

智能緩存系統

MCP服務器實現了一個先進的緩存系統，以實現最高性能：

• 🚀 自動初始化：服務器啟動時，自動進行全面的數據抓取。
• ⏰ 24小時緩存：數據在24小時內保持有效。
• ⚡ 即時響應：初始緩存完成後，所有查詢的響應時間小於100ms。
• 🔄 自動更新：24小時後，下次查詢時自動更新數據。
• 🛡️ 智能回退：若數據抓取失敗，使用上一次可用的緩存數據。

# 服務器啟動時的日誌信息
[agenda-service] 🚀 Initializing MCP Server - Starting initial cache...
[agenda-service] ✅ Initial cache ready! Scraped 45 talks in 8500ms
[agenda-service] ⚡ MCP Server ready - All queries will be INSTANT for 24 hours!

# 後續查詢時的日誌信息
[agenda-service] ⚡ Using cached data (15min old, 23h left) - INSTANT response!

📦 安裝指南

# 若未安裝pnpm，可使用以下命令進行安裝
npm install -g pnpm

# 安裝項目依賴
pnpm install

💻 使用示例

基礎用法 - Transport STDIO（Claude Desktop）

# 啟動適用於Claude Desktop的MCP服務器
node src/index.js

# 或者使用npm腳本啟動
pnpm start

高級用法 - Transport HTTP/SSE（遠程連接）

# 啟動使用HTTP傳輸的MCP服務器
MCP_TRANSPORT=http node src/index.js

# 指定端口啟動
MCP_TRANSPORT=http PORT=8000 node src/index.js

# 或者使用npm腳本啟動
pnpm start:http

# 使用環境變量啟動
MCP_TRANSPORT=http MCP_PORT=8000 pnpm start

📚 詳細文檔

Claude Desktop配置

選項1：STDIO傳輸（推薦）

{
    "mcpServers": {
        "nerdearla-agenda-mcp": {
            "command": "node",
            "args": ["/ruta/absoluta/al/proyecto/src/index.js"]
        }
    }
}

選項2：HTTP傳輸（遠程）

{
    "mcpServers": {
        "nerdearla-agenda-mcp": {
            "command": "node",
            "args": ["/ruta/absoluta/al/proyecto/src/index.js", "http", "3000"]
        }
    }
}

文件位置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

測試

使用MCP Inspector

# 使用MCP Inspector（STDIO傳輸）
DANGEROUSLY_OMIT_AUTH=true npx @modelcontextprotocol/inspector node src/index.js

# 然後打開：http://localhost:6274

手動測試

# 測試STDIO傳輸
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | node src/index.js

# 測試HTTP傳輸 - 健康檢查
curl http://localhost:3000/health

# 測試HTTP傳輸 - 服務器信息
curl http://localhost:3000/

# 測試MCP端點（可流式傳輸的HTTP）
curl http://localhost:3000/mcp

使用MCP Inspector進行測試

# 選項1：自動腳本（推薦）
pnpm run inspector

# 選項2：手動方式
npx @modelcontextprotocol/inspector npx nerdearla-agenda

# 選項3：使用HTTP服務器
# 1. 啟動服務器
pnpm start:http

# 2. 在Inspector界面中設置：
#    傳輸類型：Streamable HTTP
#    URL：http://localhost:3000/mcp

項目架構

src/
├── index.js          # 包含傳輸層的主MCP服務器
├── agenda-service.js # 業務邏輯（工具）
├── scraper.js        # 使用Puppeteer進行網頁抓取
├── time-utils.js     # GMT - 3時間工具
└── mcp-tools.js      # MCP工具定義

工具執行示例

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "get_upcoming_talks",
        "arguments": {
            "limit": 3
        }
    }
}

響應示例：

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "content": [
            {
                "type": "text",
                "text": "{\n  \"currentTime\": \"2025-09-23T15:30:00-03:00\",\n  \"upcomingTalks\": [...],\n  \"total\": 3\n}"
            }
        ]
    }
}

構建和分發

Node.js

# 創建包
pnpm build

# 全局安裝
pnpm install:global

# 全局使用
npx nerdearla-agenda-mcp
npx nerdearla-agenda-mcp http

版本發佈

當前版本：v1.2.0 - 智能緩存系統

• ⚡ 啟動時自動緩存：從一開始就實現即時響應。
• 🕒 24小時緩存：通過自動更新實現最高性能。
• 🐳 優化的Docker：遷移到pnpm並進行了更好的配置。
• 🛠️ 新工具：get_cache_info 用於系統監控。
• 🔗 包含URL：演講信息中包含可用的鏈接。

查看 CHANGELOG.md 以獲取完整的版本歷史記錄。

Docker

# 使用Docker Compose運行（推薦）
docker-compose up --build

# 在後臺運行
docker-compose up -d --build

# 僅使用Docker
docker build -t nerdearla-agenda-mcp .
docker run -p 3000:3000 nerdearla-agenda-mcp

# 使用認證
docker run -p 3000:3000 \
  -e MCP_BEARER=mi-token-secreto \
  nerdearla-agenda-mcp

查看 DOCKER_GUIDE.md 以獲取高級配置信息。

傳輸層對比

MCP文檔

• MCP架構
• MCP規範
• 傳輸層

關於演講

"Automatizá con flow: IA, n8n y MCP sin morir en el intento"

在本次演講中，我們展示瞭如何創建智能工作流，連接以下組件：

• 🤖 Claude/人工智能 用於智能處理
• 🔗 n8n 用於工作流編排
• ⚡ MCP 用於外部系統集成
• 🌐 REST API 用於通用連接

演示的技術棧

• MCP SDK 1.x - 與人工智能的通信協議
• Node.js + TypeScript - 運行時和類型檢查
• Puppeteer - 動態網頁抓取
• Express - HTTP服務器
• n8n - 可視化自動化工具
• Claude Desktop - 原生MCP客戶端

🔧 技術細節

• 符合MCP標準：遵循官方MCP架構。
• 多傳輸方式：支持STDIO（本地）和HTTP/SSE（遠程）的專業模式。
• 工具發現：實現 tools/list 用於動態發現工具。
• 工具執行：實現 tools/call 用於執行工具。
• HTTP功能：支持健康檢查、CORS、可選的Bearer令牌認證。
• 會話管理：管理SSE會話並自動清理。
• 智能抓取：使用Puppeteer抓取React SPA的動態內容。
• 智能緩存：啟動時自動初始化，24小時緩存以實現即時響應。
• GMT - 3時區處理：正確處理阿根廷本地時間。
• 環境變量配置：通過 MCP_TRANSPORT、MCP_PORT 等環境變量進行靈活配置。

👥 作者

🌟 項目反饋

如果你覺得這個MCP服務器有用：

• ⭐ 給倉庫點個星
• 🐛 發現問題請提交Bug報告
• 💡 通過Issues提出改進建議
• 🔄 與其他開發者分享

📄 許可證

本項目採用MIT許可證，你可以自由地在自己的項目中使用此代碼。

為Nerdearla 2025社區用心開發 ❤️