Nylas Api MCP

🚀 Nylas API MCPサーバー（実験的）

このプロジェクトは、Nylas APIをベースとしたモデルコンテキストプロトコル（MCP）サーバーを実装しています。開発者には、Nylas APIに関連する電子メール、カレンダー、連絡先機能を理解し、統合するためのリソース、ツール、ヒントが提供されます。

⚠️ 重要提示

このプロジェクトは実験段階にあり、モデルコンテキストプロトコル（MCP）をNylas API統合のガイドとして使用することを探索することを目的としています。公式リリースではなく、学習と実験目的のみで使用されます。

🚀 クイックスタート

このセクションでは、Nylas API MCPサーバーのセットアップと使用方法を説明します。

依存関係の要件

• Node.js 18+ バージョン
• npm パッケージマネージャー

インストール

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

npm install

3. プロジェクトをビルドします。

npm run build

MCPサーバーの実行

標準入出力を使用する（MCPクライアントと直接統合）

npm start

HTTPとSSEを使用する（リモート接続）

MCP_MODE=http npm start

デフォルトでは、HTTPサーバーはポート3000で実行されます。PORT環境変数を設定することで、このポートを変更できます。

MCP_MODE=http PORT=8080 npm start

✨ 主な機能

このMCPサーバーは以下の機能を提供します。

• ドキュメントリソース：包括的なNylas APIエンドポイント、認証、およびベストプラクティスのドキュメント
• コード例：複数のプログラミング言語（Node.js、Python、Java、Ruby、curl）での様々なNylas API操作の即使用可能なコード例
• インタラクティブツール：認証コードと特定のエンドポイント実装コードを生成するツール
• ヒント：一般的なNylas統合シナリオにおける事前構築されたヒント

📚 ドキュメント

何がMCPですか？

モデルコンテキストプロトコル（MCP）は、データ、ツール、およびヒントを人工知能アプリケーションに統合するための標準です。MCPサーバーは、AIアプリケーション（Claude Desktop、CursorなどのMCP互換アプリケーション）にリソース、ツール、およびヒントを公開することができます。

リソース

このMCPサーバーは以下のリソースを提供します。

• 一般的なドキュメント：Nylas API機能の概要
• 認証ガイド：Nylas APIとの認証方法
• APIエンドポイント：電子メール、カレンダー、および連絡先に関連するエンドポイントのドキュメント
• コード例：さまざまなプログラミング言語を使用したNylas API操作の実装例

プロジェクト構造

プロジェクトのルートディレクトリには、以下の主要なファイルとフォルダが含まれています。

• index.js：メインアプリケーションのエントリポイント
• package.json：プロジェクトの依存関係とスクリプトの設定
• public/：HTML、CSS、JavaScriptファイルなどの静的リソース
• src/：サーバーロジックとルート処理を含むソースコードファイル

設定オプション

• PORT：サーバーが実行されるポートを指定します。デフォルトは3000です。
• NODE_ENV：環境モードを設定します。developmentまたはproductionにすることができます。

💻 使用例

基本的な使用法

メールの送信

POST /api/send-email

{
  "to": "recipient@example.com",
  "subject": "Test Email",
  "text": "This is a test email."
}

カレンダーイベントの取得

GET /api/calendar/events

高度な使用法

このMCPサーバーは、Claude DesktopやCursorなどのMCP互換アプリケーションと統合することができます。

Claude Desktop

1. 標準入出力モードでMCPサーバーを起動します。
2. Claude Desktopで、設定 > サーバーに移動します。
3. 「サーバーを追加」をクリックします。
4. 「ローカルコマンドを実行」を選択し、このサーバーを起動するコマンドを入力します。

node /path/to/nylas-api-mcp/dist/index.js

5. 名前を付けます（例：「Nylas API」）。
6. 追加が完了すると、Claudeの会話ですべてのNylas APIリソース、ツール、およびヒントを使用できます。

Cursor

1. 標準入出力モードでMCPサーバーを起動します。
2. Cursorで新しいMCPサーバー設定を追加します。
3. 以下のコマンドを使用するように構成します。

node /path/to/nylas-api-mcp/dist/index.js

🤝 貢献ガイド

1. このプロジェクトを自分のリポジトリにフォークします。
2. 機能ブランチを作成し、変更をコミットします。
3. コードをプッシュし、プルリクエストを作成します。

📄 ライセンス

MIT