Nerdearla Agenda MCP

🚀 Nerdearla Agenda - MCP Server

このプロジェクトは、Model Context Protocol (MCP) を使用したサーバーで、Nerdearlaのアジェンダにリアルタイムでアクセスできるようにします。公式のMCPアーキテクチャに沿って開発されています。

🚀 クイックスタート

このサーバーを使用することで、Nerdearlaのアジェンダ情報にリアルタイムでアクセスできます。以下の手順でサーバーを起動し、アジェンダ情報を取得しましょう。

✨ 主な機能

提供されるツール

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 Transport (推奨)

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

オプション2: HTTP Transport (リモート)

{
    "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 transport)
DANGEROUSLY_OMIT_AUTH=true npx @modelcontextprotocol/inspector node src/index.js

# 次にブラウザで開く: http://localhost:6274

手動テスト

# STDIO transportのテスト
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | node src/index.js

# HTTP transportのヘルスチェック
curl http://localhost:3000/health

# HTTP transportのサーバー情報
curl http://localhost:3000/

# MCPエンドポイントのテスト (Streamable 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. インスペクターのインターフェイスで:
#    Transport Type: 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仕様
• トランスポート層

🔧 技術詳細

• MCP準拠: 公式のMCPアーキテクチャに沿っています。
• 複数のトランスポート: ローカルのSTDIOとリモートのHTTP/SSEをサポートしています。
• ツールの発見: tools/list を実装して、動的なツール発見ができます。
• ツールの実行: tools/call を実装して、ツールの実行ができます。
• HTTP機能: ヘルスチェック、CORS、オプションのBearerトークン認証をサポートしています。
• セッション管理: SSEセッションの自動クリーンアップを行います。
• スマートスクレイピング: React SPAの動的コンテンツを取得するためにPuppeteerを使用しています。
• スマートキャッシュ: 起動時の自動初期化と24時間のキャッシュにより、即時応答が可能です。
• GMT-3タイムゾーン: アルゼンチンの時間を正しく扱います。
• 環境変数: MCP_TRANSPORT, MCP_PORT などの柔軟な設定が可能です。

👥 作者

🎯 講演について

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

この講演では、以下の要素を接続するインテリジェントなワークフローを作成する方法をデモンストレーションします。

• 🤖 Claude/IA - インテリジェントな処理
• 🔗 n8n - ワークフローのオーケストレーション
• ⚡ MCP - 外部システムの統合
• 🌐 APIs REST - 普遍的な接続性

🛠️ デモンストレーションされた技術スタック

• MCP SDK 1.x - IAとの通信プロトコル
• Node.js + TypeScript - ランタイムと型付け
• Puppeteer - 動的なウェブスクレイピング
• Express - HTTPサーバー
• n8n - ビジュアル自動化
• Claude Desktop - ネイティブのMCPクライアント

🌟 プロジェクトが気に入りましたか？

このMCPサーバーが役に立った場合は、以下のことをお願いします。

• ⭐ リポジトリにスターをつける
• 🐛 バグが見つかったら報告する
• 💡 改善提案をIssueで送る
• 🔄 他の開発者と共有する

📄 ライセンス

MITライセンスです。このコードをあなた自身のプロジェクトで自由に使用してください。

Desarrollado con ❤️ para la comunidad de Nerdearla 2025