Lkm1developer Hubspot MCP Server

🚀 HubSpot MCPサーバー

このプロジェクトは、TypeScriptで書かれた強力なMCP（Model Context Protocol）サーバーの実装です。HubSpot CRMとの統合を目的として設計されており、AIアシスタントがHubSpotのデータとやり取りできるようにすることが主な目的です。

🚀 クイックスタート

このセクションでは、HubSpot MCPサーバーをインストール、設定、実行する手順を説明します。

📦 インストール

1. リポジトリのクローン

git clone https://github.com/yourusername/hubspot-mcp-server.git
cd hubspot-mcp-server

2. 依存関係のインストール

npm install

3. プロジェクトのビルド

npm run build

4. 設定

• 環境変数を使用する場合：

HUBSPOT_API_KEY=your_api_key_here

• または、コマンドライン引数でAPIキーを指定してサーバーを起動する場合：

npm start -- --apiKey your_api_key_here

🔧 サーバーの実行

ローカルでの実行

npm run dev

本番環境での実行

npm start

Dockerでのデプロイ

# Dockerfile
FROM node:16

WORKDIR /app

COPY package*.json ./

RUN npm install

COPY . .

CMD ["node", "dist/index.js"]

💻 使用例

基本的な使用法

以下は、サーバーがサポートするツールとその詳細な説明です。

1. 会社の作成

{
  toolName: 'hubspot_create_company',
  parameters: {
    name: string,
    properties?: object
  }
}

2. 会社の活動記録の取得

{
  toolName: 'hubspot_get_company_activity',
  parameters: {
    companyId: string
  }
}

3. 最近のエンゲージメント記録の取得

{
  toolName: 'hubspot_get_recent_engagements',
  parameters: {
    days?: number,
    limit?: number
  }
}

4. 最もアクティブな会社の取得

{
  toolName: 'hubspot_get_active_companies',
  parameters: {
    limit?: number
  }
}

5. 最もアクティブな連絡先の取得

{
  toolName: 'hubspot_get_active_contacts',
  parameters: {
    limit?: number
  }
}

6. 連絡先情報の更新

{
  toolName: 'hubspot_update_contact',
  parameters: {
    contactId: string,
    properties: object
  }
}

7. 会社情報の更新

{
  toolName: 'hubspot_update_company',
  parameters: {
    companyId: string,
    properties: object
  }
}

📚 詳細ドキュメント

サーバーの拡張

新しいHubSpot API機能を追加するには、以下の手順に従ってください。

1. src/hubspot-client.tsのHubSpotClientクラスに新しいメソッドを追加します。
2. src/index.tsのsetupToolHandlersメソッドで新しいツールを登録します。
3. npm run buildコマンドでプロジェクトを再構築します。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。