Limitless MCP Server

無制限の MCP サーバー (v0.1.0)

これはMCP（モデル・コンテキスト・プロトコル）サーバーで、 Limitless APIを介してLimitlessペンダントのデータをClaude、WindsurfなどのAIツールに接続します。これにより、AIチャットインターフェースやエージェントが、構造化されたプログラミング可能な方法でライフログとやり取りできるようになります。より組織的でインテリジェントな未来に向けて、コンテキストリッチなインタラクションを一つずつ構築していきましょう。

MCPとは何ですか？
モデルコンテキストプロトコルは、AIモデルを外部ツールやデータに接続するためのオープンスタンダードです。USB-CポートやAI用HTTPプロトコルのように、汎用性、信頼性、拡張性を重視して設計されています。誰もが採用する標準規格です。AIと日常的に使用するツール間の高度な統合、カスタムワークフロー、そしてシームレスな通信を実現します。

重要事項： 2025年3月以降、Limitless APIはLimitlessペンダント経由で記録されたデータを必要とします。このサーバーはLimitlessペンダントから記録された実際のデータに依存しており、データがないと意味のある結果を返しません。ペンダントが接続され、記録中であることを確認してください。

API のステータスと今後の計画:

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

機能 (v0.1.0)

• ライフログの一覧表示/取得: ID、日付、日付範囲でペンダントの記録を取得したり、最近のエントリを一覧表示したりできます。並べ替えの方向（ asc / desc ）も制御できます。
• **最近のログの検索:**設定可能な数の最近のペンダント録画の内容内で簡単なテキスト検索を実行します (注: 検索可能なのは最近のログのみで、完全な履歴検索はサポートされていません)。

このサーバーを使用すると、Lifelog からアクション項目を取得し、Claude、ChatWise、Windsurf、または MCP をサポートするその他の AI アシスタント/アプリを介して Notion に直接送信するなどの操作を実行できます。

前提条件

• Node.js (v18以降が必要)
• npmまたはyarn
• Limitless アカウントと API キー (こちらから取得)
• 無限のペンダント（データに必要）
• 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クライアントの設定ファイルにサーバー構成ブロックを追加する必要があります。以下に、最初のサーバーとして追加する場合と、既存のサーバーと併用する場合の2つの例を示します。

例A: 最初の/唯一のサーバーとして追加する

クライアントの構成ファイルに現在空のmcpServersオブジェクト ( "mcpServers": {} ) がある場合は、これを次のように置き換えます。

例B: 既存のサーバーへの追加

mcpServersオブジェクトにすでに他のサーバー ( "notion": {...}など) が含まれている場合は、それらの横に"limitless"ブロックを追加し、正しい JSON 構文 (エントリ間のコンマ) を確認します。

重要：

• <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 で単一のペンダント記録を取得します。
2. limitless_list_lifelogs_by_date : 特定の日付のペンダントの録音を一覧表示します。
3. limitless_list_lifelogs_by_range : 日付/時刻範囲内のペンダント録画を一覧表示します。
4. limitless_list_recent_lifelogs : 最新のペンダントの録音を一覧表示します。
5. limitless_search_lifelogs :最近のペンダント録画のタイトル/コンテンツを検索します (範囲は限定されています)。

注意事項と制限事項

🚫ペンダントが必要です
このサーバーは、Limitless ペンダントによって生成されたデータに依存します。

🧪 API ベータ ステータス
Limitless APIはベータ版であり、不安定になったり、レート制限が発生したりする場合があります。大規模なリクエストはタイムアウト（例：504エラー）を引き起こす可能性があります。

🔍検索範囲
limitless_search_lifelogs 、最近のログを限られた数だけスキャンします（デフォルトは20件、最大100件）。全履歴を検索するわけではありません。より広範な分析を行うには、まずリストツールをご利用ください。

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

🔌交通
このサーバーはstdioを使用し、MCP 互換のクライアント アプリによって起動されるように設計されています。

貢献

アイデア、改善点、フィードバックなどございましたら、お気軽にIssueまたはPRをご提出ください。貢献はいつでも歓迎いたします！ウェアラブルコンテキストとインテリジェントツールの可能性の限界を押し広げていきましょう。https ://github.com/ipvr9/mcp-limitless-server