Limitless MCP Server (v0.1.0)

Limitless MCP Server (v0.1.0)

これは、Limitless APIを介して、Limitless PendantのデータをClaude、WindsurfなどのAIツールに接続するMCP（Model Context Protocol）サーバーです。AIチャットインターフェースやエージェントが、構造化されたプログラム可能な方法でLifelogとやり取りできるようにします。コンテキスト豊かなやり取りを一つずつ積み重ね、より整理されたインテリジェントな未来を築きましょう。

MCPとは？
Model Context Protocolは、AIモデルを外部のツールやデータに接続するためのオープンスタンダードです。AI向けのUSB-Cポート、あるいはHTTPプロトコルのようなものと考えてください。汎用性と信頼性が高く、拡張性を考慮して設計されています。誰もが採用するスタンダードです。豊富な連携、カスタムワークフロー、AIと日々使うツール間のシームレスな通信を実現します。

重要な注意事項： 2025年3月現在、Limitless APIではLimitless Pendantで記録されたデータが必要です。このサーバーはLimitless Pendantで実際に記録されたデータに依存しているため、そのようなデータがなければ有用な結果は返されません。Pendantが接続され、記録中であることを確認してください。

APIの状況と今後の計画：

• 公式のLimitless APIは現在ベータ版です。そのため、時折動作が不安定になったり、変更されたり、一時的に停止したりすることがあります。
• 大量のデータ（例：数百件のログの一覧表示や検索）をリクエストすると、APIやネットワークの制約により、**タイムアウトエラー（504 Gateway Time-outなど）**が発生することがあります。これを軽減するため、このサーバーではAPI呼び出しごとに120秒のタイムアウトを設定していますが、非常に大きなリクエストは失敗する場合があります。
• Limitless APIは活発に開発中です。公式APIで新機能や改善が利用可能になり次第、このMCPサーバーも更新されます。
• このMCPサーバーのバージョン0.2.0はすでに開発中で、近い将来、より堅牢な機能や新しいツールの追加を予定しています。

機能（v0.1.0）

• Lifelogの一覧表示／取得： Pendantの記録を、ID、日付、日付範囲で取得したり、最近の記録を一覧表示したりできます。並べ替え順（asc／desc）も指定できます。
• 最近のログを検索： 設定可能な件数の最近のPendant記録を対象に、内容を簡単なテキスト検索で検索できます（注：検索できるのは最近のログのみです。全履歴の検索には対応していません）。

このサーバーを使えば、Claude、ChatWise、Windsurf、その他のMCP対応AIアシスタント／アプリを介して、Lifelogからアクションアイテムを抽出し、Notionに直接送信するといったことができます。

前提条件

• Node.js（v18以降が必要）
• npmまたはyarn
• LimitlessアカウントとAPIキー（こちらから取得）
• Limitless Pendant（データ取得に必須）
• stdioサーバーを起動し、環境変数を渡せるMCPクライアントアプリケーション（例：Claude、Windsurf、Cursor、ChatWise、ChatGPT（近日対応予定！））

セットアップ

1. このプロジェクトをクローンまたはダウンロードします。
2. ディレクトリに移動します：

   cd mcp-limitless-server
   

3. 依存関係をインストールします：

   npm install
   

4. コードをビルドします：

   npm run build
   

設定（クライアント側）

このサーバーを MCP クライアントで起動する際は、LIMITLESS_API_KEY を環境変数として指定する必要があります。

MCP クライアントの設定ファイルにサーバー設定ブロックを追加してください。初めてサーバーを追加する場合と、既存のサーバーに追加する場合の例を以下に示します。

例 A：最初／唯一のサーバーとして追加する場合

クライアントの設定ファイルで mcpServers オブジェクトが空（"mcpServers": {}）の場合は、次の内容に置き換えてください。

{
  "mcpServers": {
    "limitless": {
      "command": "node",
      "args": ["<FULL_FILE_PATH_TO_DIST_SERVER.js>"],
      "env": {
        "LIMITLESS_API_KEY": "<YOUR_LIMITLESS_API_KEY_HERE>"
      }
    }
  }
}

例 B：既存のサーバーに追加する場合

mcpServers オブジェクトにすでにほかのサーバー（"notion": {...} など）が含まれている場合は、正しい JSON 構文（エントリ間のカンマ）を守って、"limitless" ブロックを並べて追加してください。

{
  "mcpServers": {
    "some_other_server": {
      "command": "...",
      "args": ["..."],
      "env": {
        "EXAMPLE_VAR": "value"
      }
    },
    "limitless": {
      "command": "node",
      "args": ["<FULL_FILE_PATH_TO_DIST_SERVER.js>"],
      "env": {
        "LIMITLESS_API_KEY": "<YOUR_LIMITLESS_API_KEY_HERE>"
      }
    }
  }
}

重要：

• <FULL_FILE_PATH_TO_DIST_SERVER.js> を、ビルド済みのサーバースクリプトへの正しい絶対パス（例：/Users/yourname/Documents/MCP/mcp-limitless-server/dist/server.js）に置き換えてください。クライアントによっては相対パスが確実に機能しない場合があります。
• <YOUR_LIMITLESS_API_KEY_HERE> を実際の Limitless API キーに置き換えてください。
• MCP 設定ファイルにはコメントを記述できません。<YOUR_LIMITLESS_API_KEY_HERE> のようなプレースホルダーテキストを削除し、実際のキーに置き換えてください。

サーバーの実行（クライアント経由）

npm start を直接実行しないでください。

1. サーバーが正常にビルドされていることを確認します（npm run build）。
2. 上記のとおり MCP クライアントを設定します。
3. MCP クライアントアプリケーションを起動します。必要に応じて、mcp-limitless-server プロセスが自動的に起動されます。

公開されている MCP ツール（v0.1.0）

（詳細については、src/server.tsを参照するか、クライアント経由でサーバーに問い合わせてください。）

1. limitless_get_lifelog_by_id：指定した ID の Pendant 録音を 1 件取得します。
2. limitless_list_lifelogs_by_date：指定した日付の Pendant 録音を一覧表示します。
3. limitless_list_lifelogs_by_range：指定した日時の範囲内の Pendant 録音を一覧表示します。
4. limitless_list_recent_lifelogs：直近の Pendant 録音を一覧表示します。
5. limitless_search_lifelogs：直近の Pendant 録音のタイトル／内容を検索します（対象範囲に制限があります！）。

注意事項と制限

🚫 Pendant が必要
このサーバーは、Limitless Pendant が生成するデータに依存します。

🧪 API のベータ版ステータス
Limitless API はベータ版のため、不安定になる場合やレート制限が発生する場合があります。大きなリクエストではタイムアウト（例：504 エラー）が発生することがあります。

🔍 検索範囲
limitless_search_lifelogs は、直近のログを限られた件数のみ検索します（デフォルトは 20 件、最大 100 件）。全履歴は検索されないため、より広範な分析を行うには、まず一覧表示ツールを使用してください。

⚠️ エラー処理とタイムアウト
API エラーは MCP エラー結果に変換されます。各 API 呼び出しのタイムアウトは 120 秒です。

🔌 トランスポート
このサーバーは stdio を使用し、MCP 互換のクライアントアプリによって起動されることを想定しています。

コントリビューション

アイデア、改善案、フィードバックがありましたら、お気軽に issue または PR を作成してください。コントリビューションをいつでも歓迎します！ウェアラブルから得られるコンテキストとインテリジェントなツールの可能性を、さらに広げていきましょう。https://github.com/ipvr9/mcp-limitless-server