Hubspot MCP Server

🚀 HubSpot MCP サーバ

このサーバは、HubSpot CRM システムとのインタラクションを可能にする Model Context Protocol (MCP) サーバです。このサーバを使用することで、連絡先や会社の情報の作成や更新、活動履歴や最近のインタラクションデータの取得など、様々な機能を利用できます。

✨ 主な機能

• TypeScript 開発：最新の TypeScript 言語を使用して開発されており、コードの明瞭性と型安全性を保証します。
• 非同期操作：Promise を使用した非同期 IO 操作により、パフォーマンスを向上させます。
• モジュール化設計：モジュール化された構造を採用しており、拡張と保守が容易です。
• 充実したドキュメント：詳細な API ドキュメントと使用説明書が提供されています。

📦 インストール

1. プロジェクトリポジトリをクローンします：

   git clone <repository-url>
   cd hubspot-mcp-server
   

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

📚 設定説明

• 環境変数：サーバが HubSpot API に接続できるように、HUBSPOT_API_KEY 環境変数を設定する必要があります。

💻 使用例

連絡先管理

1. 連絡先を作成する：

   npm run create-contact -- [姓名] [邮箱]
   

2. 連絡先情報を更新する：
 ```bash
 npm run update-contact -- [联系人ID] [属性]

会社管理

1. 会社を作成する：

   npm run create-company -- [公司名称]
   

2. 会社情報を更新する：
 ```bash
 npm run update-company -- [公司ID] [属性]

活動記録の照会

1. 特定の会社の活動履歴を取得する：

   npm run get-company-activity -- [公司ID]
   

2. 最近のインタラクションを確認する：
 ```bash
 npm run get-recent-engagements -- [--天数=7] [--限制=50]

📚 よくある質問

1. API キーを取得する方法は？

   • HubSpot アカウントにログインし、設定で開発者ツールを見つけて、新しい API キーを生成します。

2. サーバが起動しない場合はどうすればいいですか？

   • 環境変数が正しく設定されていることを確認し、ネットワーク接続が正常であることを確認します。

🔧 拡張説明

1. 新機能の追加：HubSpotClient クラスを拡張し、setupToolHandlers メソッドで新しいツールを登録することで、より多くの HubSpot API 機能を簡単に追加できます。
2. カスタムログ：必要に応じてログレベルを変更することで、より詳細なデバッグ情報を出力できます。

📄 ライセンス

このプロジェクトは MIT ライセンスに基づいています。詳細については、LICENSE ファイルを参照してください。

キーワード

HubSpot, CRM, モデルコンテキストプロトコル, MCP, AI アシスタント, TypeScript, API 統合, HubSpot API, CRM 統合, 連絡先管理, 会社管理, インタラクション追跡, AI ツール