Dex MCP Server

Dex MCP サーバー

v1.0.0 がリリースされました！

• 主な変更点とアップグレード情報については、RELEASE-NOTES.md と GitHub Releases をご覧ください。
• アップグレード方法：
  1. 最新のコードを取得します：git pull --rebase origin main
  2. .env ファイルが存在し、有効な DEX_API_KEY が含まれていることを確認します。
  3. 必要に応じて、エージェントの起動前に kill-dex-mcp-server.sh スクリプトを使用します。
  4. エージェント／CLI の使用方法とベストプラクティスについては、copilot-instructions.md をご覧ください。

Dex API を通じて、AI エージェントに包括的な連絡先関係管理機能を提供する Model Context Protocol（MCP）サーバーです。

機能

🚀 連絡先の管理

• 連絡先の作成、読み取り、更新、削除を詳細情報とともに実行
• 名前、メールアドレス、会社名で連絡先を検索
• 包括的な連絡先フィールド：名前、会社名、役職、説明、メールアドレス、電話番号

📝 メモの管理

• タイムライン項目として保存される、連絡先に紐付いたメモ
• 任意の連絡先のメモを作成、更新、削除
• すべての連絡先のメモを内容で検索
• 大量のメモを扱うためのページネーションに対応

⏰ リマインダーの管理

• 特定の連絡先に紐付いたリマインダーを設定
• 必要に応じてリマインダーを完了、更新、削除
• リマインダーをテキスト内容で検索
• 繰り返しのフォローアップに対応
• 適切な日付形式で期限を追跡

インストール

前提条件

• Node.js 18 以降
• Dex API アカウントと API キー

セットアップ

1. このリポジトリをクローンします：

git clone https://github.com/alpabon73/dex-mcp-server.git
cd dex-mcp-server

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

npm install

3. src/index.ts で Dex API キーを設定します：

const API_KEY = 'your-dex-api-key-here';

4. サーバーをビルドします：

npm run build

環境変数

このプロジェクトには Dex API キーが必要です。実際の API キーを公開リポジトリにコミットしないでください。

1. .env.example を .env にコピーします：

   cp .env.example .env
   

2. .env を編集し、実際の Dex API キーを設定します：

   DEX_API_KEY=your-dex-api-key-here
   

3. 環境または .env ファイルに DEX_API_KEY が設定されていない場合、サーバーは起動しません。

.env はすでに .gitignore に登録されており、コミットされることはありません。

使用方法

単独での使用

npm start

AnythingLLM との使用

MCP サーバーの設定に追加します：

{
  "servers": {
    "dex-mcp": {
      "command": "/usr/local/bin/node",
      "args": ["/path/to/dex-mcp-server/dist/index.js"],
      "env": {}
    }
  }
}

利用可能なツール

連絡先ツール（6）

• get_contacts - ページネーションを使用して連絡先を取得
• get_contact_by_id - 特定の連絡先の詳細を取得
• search_contacts - 名前、会社名、メールアドレスで検索
• create_contact - 新しい連絡先を追加
• update_contact - 既存の連絡先を変更
• delete_contact - 連絡先を削除

メモツール（6）

• get_notes_by_contact - 連絡先のすべてのメモを取得
• get_all_notes - ページネーションを使用してすべてのメモを取得
• search_notes - メモを内容で検索
• create_note - 連絡先にメモを追加
• update_note - 既存のメモを変更
• delete_note - メモを削除

リマインダーツール（6）

• get_reminders_by_contact - 連絡先のリマインダーを取得
• get_all_reminders - ページネーションを使用してすべてのリマインダーを取得
• search_reminders - リマインダーをテキストで検索
• create_reminder - 新しいリマインダーを設定
• update_reminder - 既存のリマインダーを変更
• complete_reminder - リマインダーを完了済みとしてマーク
• delete_reminder - リマインダーを削除

メモで使用できるミーティングの種類

メモを作成する際は、表示名または Dex API の列挙値を使ってミーティングの種類を指定できます。受け付けられる値は次のとおりです。

表示名	Dex API の列挙値
メモ	note
通話	call
メール	email
テキスト／メッセージング	text_messaging
Linkedin	linkedin
Skype／Teams	skype_teams
Slack	slack
コーヒー	coffee
ネットワーキング	networking
パーティー／交流会	party_social
その他	other
食事	meal
ミーティング	meeting
カスタム	custom

上記の表示名（大文字と小文字は区別されず、スペースとスラッシュも使用できます）または正確な列挙値を指定できます。システムが入力を適切な Dex API の値に自動で対応付けます。

使用例

• 「TechCorp の John Smith を新しい連絡先として追加」
• 「来週、Sarah にフォローアップするリマインダーを設定」
• 「ABC プロジェクトに関するすべてのメモを検索」
• 「Mike の役職を Senior Engineer に更新」
• 「今月の保留中のリマインダーをすべて表示」
• 「今日のクライアントとのミーティングについてメモを作成」

開発

スクリプト

• npm run build - TypeScript をコンパイル
• npm run dev - ts-node を使って開発用に実行
• npm run watch - 監視モードでコンパイル
• npm start - コンパイル済みサーバーを実行

アーキテクチャ

• TypeScript による型安全性
• Zod によるスキーマ検証
• Axios による Dex API への HTTP リクエスト
• MCP SDK によるプロトコル実装

API 統合

このサーバーは、以下を使用して Dex API と統合します。

• GraphQL エンドポイント：https://api.getdex.com/v1/graphql
• メモの保存に使用する Timeline items
• 連絡先との関連付けを持つ Reminders テーブル
• 適切なページネーションと検索機能

コード品質と CI

このプロジェクトでは、型安全性に TypeScript を、コードのリントに ESLint を使用しています。すべてのコードは CI で型エラーとリントの問題がないか自動的にチェックされます（.github/workflows/ci.yml を参照）。

• ローカルで型チェックを実行：

  npm run build # or npx tsc --noEmit
  

• ローカルでリンターを実行：

  npm run lint
  

すべてのプルリクエストは、マージ前に CI チェックに合格する必要があります。

Issue と PR のテンプレート

• バグ報告と機能リクエストには、一貫性を保つため GitHub の Issue テンプレートを使用します。
• 品質とドキュメントを確保するため、すべてのプルリクエストで PR テンプレートを使用します。

セキュリティとシークレット

• シークレットや API キーは絶対にコミットしないでください。 .env は gitignore されており、シークレットは環境変数から読み込まれます。
• シークレットをコミットしてしまった場合は、リポジトリの履歴削除手順に従ってください（scrub-git-history.sh を参照）。

貢献

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更を加えます
4. 必要に応じてテストを追加します
5. npm run lint と npm run build を実行して、コード品質を確認します
6. プルリクエストを送信します

ライセンス

MIT License - 詳細は LICENSE file を参照してください

サポート

次の項目に関する問題について：

• Dex API：Dex のドキュメントを確認してください
• MCP Protocol：MCP の仕様を参照してください
• このサーバー：このリポジトリで Issue を作成してください

---

問題の報告または貢献方法

• バグを見つけた、または機能リクエストがありますか？Issue を作成してください
• 貢献したいですか？ガイドラインについては CONTRIBUTING.md を参照してください。
• セキュリティ上の懸念がありますか？責任ある情報開示については SECURITY.md を参照してください。
• リリースノートとアップグレード情報については、RELEASE-NOTES.md と CHANGELOG.md を参照してください。