Advanced Limitless MCP Server (v0.3.1) 🚀

Limitless MCP サーバー - 強化版

概要

Limitless Pendant の録音から会話を高度に分析するモデルコンテキストプロトコル（MCP）サーバーです。会議のインテリジェントな検出、アクションアイテムの抽出、包括的な分析を提供します。

v0.13.0 の新機能

• 完全なページネーション対応：すべてのツールで、大規模なデータセットをページネーションで適切に処理できるようになりました
• レガシー機能の削除：コア機能に集中するため、音声活性度ツールを整理しました
• 残りのツールを修正：会議の検出、アクションアイテム、トランスクリプト、詳細な分析のすべてでページネーションを使用するようになりました
• パフォーマンスの向上：最適なパフォーマンスを実現するため、すべてのツールで API の上限を一貫して 10 項目に設定しました

以前の更新（v0.12.0）

• トークン上限の処理を強化：上限を超える応答をより積極的に切り詰めるようになりました
• 検索ツールを修正：limitless_search_lifelogs がトークン上限を適切に処理するようになりました
• 応答の安全性を向上：トークン数を推定する前に、配列を事前に切り詰めるようになりました
• エラーをより効果的に防止：すべてのツールで、安全な応答ラッパーを一貫して使用するようになりました

以前の更新（v0.11.0）

• トークン上限への対応：大規模なデータセットを処理するため、スマートなページネーションと応答の分割を導入しました
• 新しい全トランスクリプト取得ツール：limitless_get_full_transcript で、自動ページネーションを使って完全なデータを取得できます
• ページネーションを強化：トークン上限を回避するため、すべてのリストツールでカーソルベースのページネーションに対応しました
• インテリジェントな応答処理：上限を超える応答を自動的に検出して処理します
• 複数の出力形式：柔軟に利用できるよう、要約、完全なデータ、トランスクリプトのみのモードを用意しました

以前の更新（v0.9.0）

• スター付きライフログに対応：スターを付けた重要な会話を絞り込み、特定できます
• エラーメッセージを強化：詳細なコンテキストを含む、より具体的なエラー処理を実装しました
• タイムゾーン処理を改善：タイムゾーン検出の堅牢なフォールバック機構を導入しました
• タイムスタンプを更新：updatedAt フィールドで、ライフログの最終更新日時を追跡できます
• API との完全な同等性：公式 Limitless API のパラメーターを 100％ サポートするようになりました

主な機能

• インテリジェントな会議検出：会話から会議を自動的に特定します
• アクションアイテムの抽出：タスクや約束をコンテキストとともに見つけます
• 自然言語による時間指定：「昨日」「先週」などの表現を使用できます
• 高度な検索：関連度スコアを使って、すべての履歴から会話を検索します
• 日次要約：参加者や主要なトピックを含む包括的な分析を提供します
• 話者分析：特定の人物との会話を詳細に分析します
• スマートなページネーション：トークン上限の問題を起こさずに大規模なデータセットを処理します
• 生トランスクリプトへのアクセス：さらなる AI 処理に使える正確なトランスクリプトを取得します

インストール

npm install -g 199bio-mcp-limitless-server

使い方

Claude Desktop の設定

Claude Desktop の MCP 設定に追加します：

{
  "mcpServers": {
    "limitless": {
      "command": "npx",
      "args": ["199bio-mcp-limitless-server"],
      "env": {
        "LIMITLESS_API_KEY": "your-api-key-here"
      }
    }
  }
}

使用可能なツール

高度な分析ツール

• 自然言語による時間指定：limitless_get_by_natural_time
• 会議の検出：limitless_detect_meetings
• アクションアイテムの抽出：limitless_extract_action_items
• 詳細なトランスクリプト：limitless_get_raw_transcript
• 日次要約：limitless_get_daily_summary
• 全トランスクリプト取得ツール：limitless_get_full_transcript（v0.11.0 で新登場）

大規模なデータセットの処理（v0.11.0）

MCP サーバーは、Claude のトークン上限を超えるような大規模なデータセットを、インテリジェントに処理できるようになりました：

ページネーション対応

すべてのリストツールで、カーソルベースのページネーションを利用できます：

# First request
limitless_list_lifelogs_by_date(date="2025-07-24", limit=10)
# Returns: 10 items + cursor

# Next page
limitless_list_lifelogs_by_date(date="2025-07-24", limit=10, cursor="next_page_cursor")

全トランスクリプト取得ツール

手動でページネーションを行わずに完全なデータを取得できます：

limitless_get_full_transcript(date="2025-07-24", format="transcript_only")

使用できる形式：

• summary：主要な情報のみ（デフォルト）
• full：すべてのフィールドを含む完全なデータ
• transcript_only：トランスクリプトのテキストのみ

API リファレンス

コア型

interface Lifelog {
  id: string;
  title?: string;
  markdown?: string;
  startTime: string;
  endTime: string;
  contents?: LifelogContentNode[];
  isStarred?: boolean;  // NEW: Whether this lifelog is starred
  updatedAt?: string;   // NEW: When this lifelog was last updated
}

interface LifelogParams {
  // ... existing params ...
  isStarred?: boolean;  // NEW: Filter for starred lifelogs only
  batch_size?: number;  // NEW: Configurable batch size for performance tuning
}

開発

ソースからビルド

git clone https://github.com/199-biotechnologies/mcp-limitless-enhanced.git
cd mcp-limitless-enhanced
npm install
npm run build

テスト

# Test with real API data
LIMITLESS_API_KEY=your-key npm run dev

コントリビューション

この MCP サーバーの機能や信頼性を向上させるコントリビューションを歓迎します。

ライセンス

MIT ライセンス - 詳細は LICENSE ファイルを参照してください。

トラブルシューティング

よくある問題

「Claude hit max length」というメッセージ

このメッセージは、応答が長すぎる場合や会話のコンテキストがいっぱいになりかけている場合に、Claude Desktop の UI に表示されます。次の項目とは関係ありません。

• MCP サーバーの機能
• Claude アカウントのプラン（無料／有料）
• Limitless API の制限

解決策：新しい会話を開始するか、応答を短くするよう依頼してください。

「Unexpected end of JSON input」でサーバーがクラッシュする

これは、JSON 以外のデータがサーバーに送信された場合に発生します。MCP サーバーは HTTP ではなく、stdio 経由で JSON-RPC を使用します。

よくある間違い：HTTP クライアント、ブラウザー、または curl で接続しようとすることです。 解決策：Claude Desktop または適切な MCP クライアントを使用してください。

HTTP／ブラウザー／ngrok 経由で接続できない

MCP サーバーは HTTP サーバーではありません。stdin／stdout 経由で JSON-RPC を使用して通信します。

誤り：curl http://localhost:8008 正しい方法：Claude Desktop の MCP 設定で構成する

クエリからデータが返されない

2025 年 3 月現在、Limitless API では主に Limitless Pendant のデータが提供されます。以下を確認してください。

• Pendant が記録中であること
• 最近の会話データがあること
• API キーに適切な権限があること

MCP サーバーについて

MCP サーバーとは：

• stdio 経由で通信する JSON-RPC サービスです
• Claude Desktop および MCP 互換クライアント向けに設計されています
• AI アシスタントの機能を拡張するツールです

MCP サーバーではないもの：

• HTTP／REST API
• Web サーバー
• ブラウザーからアクセスできるサービス
• UI を備えたスタンドアロンアプリケーション

Limitless データへの HTTP アクセスが必要な場合：

1. Limitless API を直接使用する
2. 別の HTTP ラッパーサービスを作成する
3. 公式の Limitless Web インターフェースを使用する

サポート

• 問題：GitHub Issues
• ドキュメント：科学的ドキュメント
• お問い合わせ：[email protected]