Jobnimbus MCP Server

🚀 JobNimbus MCP サーバー

このプロジェクトは、モデルコンテキストプロトコル (MCP) サーバーを提供します。これを通じて、Cursor や Claude などの互換性のある AI アシスタントが JobNimbus API とやり取りできます。

このサーバーにより、AI エージェントは標準ツールを使用して、JobNimbus API キーを用いた安全なアクセスで、JobNimbus のデータ（連絡先、作業、タスク、製品、ワークフロー、請求書）にアクセスし、操作することができます。

このサーバーは npm に公開されており、npx を使って簡単に実行できます。

🚀 クイックスタート

特定のAIアシスタントの設定手順

以下の手順に従って、特定の AI アシスタント用に設定します。

Cursor Editor 用の設定

1. 前提条件：

   • Cursor Editor がインストールされている。
   • Node.js と npm（npx が必要）がインストールされている。
   • あなたの JobNimbus API キーがある。

2. Cursor の設定：

   • ホームディレクトリに ~/.cursor ディレクトリを作成します（存在しない場合）。

   • そのディレクトリ内に mcp.json ファイルを作成します（存在しない場合）。

   • mcp.json ファイルに以下の内容を追加します：

     {
       "jobnexus": {
         "apiEndpoint": "YOUR_JOBNEXUS_API_ENDPOINT",
         "apiKey": "YOUR_JOBNEXUS_API_KEY"
       }
     }
     

3. Cursor の起動：

   • ターミナルで以下を実行します：

     npx jobnexus
     

Claude 用の設定

1. 前提条件：

   • Claude がインストールされている。
   • Node.js と npm（npx が必要）がインストールされている。
   • あなたの JobNimbus API キーがある。

2. Claude の設定：

   • ターミナルで以下を実行します：

     npx jobnexus
     

✨ 主な機能

ツールの実装

• 連絡先：

  • listContacts(): すべての連絡先を取得します。
  • getContact(id): ID で特定の連絡先を取得します。
  • createContact(contact): 新しい連絡先を作成します。
  • updateContact(id, contact): 既存の連絡先を更新します。

• 作業：

  • listJobs(): すべての作業を取得します。
  • getJob(id): ID で特定の作業を取得します。
  • createJob(job): 新しい作業を作成します。
  • updateJob(id, job): 既存の作業を更新します。

• タスク：

  • listTasks(): すべてのタスクを取得します。
  • getTask(id): ID で特定のタスクを取得します。
  • createTask(task): 新しいタスクを作成します。
  • updateTask(id, task): 既存のタスクを更新します。

• 製品：

  • listProducts(): すべての製品を取得します。
  • getProduct(id): ID で特定の製品を取得します。
  • createProduct(product): 新しい製品を作成します。
  • updateProduct(id, product): 既存の製品を更新します。

• ワークフロー：

  • getAllWorkflows(): すべてのワークフローとその状態を取得します。
  • createWorkflow(workflow): 新しいワークフローを作成します。
  • createWorkflowStatus(status): 新しいワークフローの状態を作成します。

• 請求書：

  • listInvoices(): すべての請求書を取得します。
  • getInvoice(id): ID で特定の請求書を取得します。
  • createInvoice(invoice): 新しい請求書を作成します。
  • updateInvoice(id, invoice): 既存の請求書を更新します。
  • sendInvoice(id): 特定の請求書を電子メールで送信します。
  • recordPayment(id, payment): 特定の請求書に対する支払いを記録します。

🔧 開発

サーバーに貢献したり、修正したりしたい場合は、以下の手順に従ってください。

1. リポジトリをクローンします：git clone <repository_url>
2. 依存関係をインストールします：cd jobnexus-mcp-server && npm install
3. src/ ディレクトリ内の内容を変更します。
4. ビルドします：npm run build
5. ローカルでテストします（.env ファイルまたはエクスポートされた API キーが必要）：
   • 直接実行する：npm start
   • 自動リロードで実行する：npm run dev
   • グローバルテスト用にリンクする：npm link（終了したら npm unlink -g jobnexus-mcp-server を実行してください）

📄 ライセンス

MIT