Genius MCP Server

🚀 基因ius - mcp - server プロジェクトドキュメント

このサーバープロジェクトは、Model Context Protocol（MCP）プロトコルを介してGenius APIとのやり取りを可能にします。このサーバーを通じて、LLM（大規模言語モデル）とGeniusプラットフォーム間のデータ交換を実現し、曲やアーティストの情報、その他関連リソースの検索ができます。

✨ 主な機能

ツール

• genius - search：Geniusプラットフォーム上で曲、アーティストまたはその他の関連コンテンツを検索できます。
• genius - song：曲のIDを指定することで、特定の曲の情報を取得できます。
• genius - artist：アーティストのIDを指定することで、特定のアーティストの詳細情報を取得できます。

リソース

• genius - search - prompt：事前に設定されたプロンプトを提供し、ユーザーがより効率的に検索操作を行えるように支援します。

📦 インストール

環境要件

• Node.js（バージョン14以上を推奨）
• npm（Node Package Manager）

インストール手順

1. プロジェクトリポジトリをローカルにクローンします。
2. プロジェクトのルートディレクトリに.envファイルを作成し、以下の内容を追加します。

   GENIUS_ACCESS_TOKEN=your_client_access_token_here
   

3. 依存関係をインストールするために以下のコマンドを実行します。

   npm install
   

4. 開発環境での実行（リアルタイムコンパイル）：

   npm run dev
   

5. 本番環境でのビルドと実行：

   npm run build && npm start
   

📚 ドキュメント

Claude for Desktopでの設定

1. Claudeのユーザーディレクトリを開き、claude_desktop_config.jsonファイルを見つけるか、作成します。
2. 以下の内容をこのファイルに追加します。

   {
     "mcp": {
       "servers": [
         {
           "name": "Genius API",
           "type": "custom",
           "binaryPath": "/path/to/your/genius - mcp - server/build",
           "args": [],
           "env": {
             "GENIUS_ACCESS_TOKEN": "your_client_access_token_here"
           }
         }
       ]
     }
   }
   

3. ファイルを保存し、Claudeアプリケーションを再起動します。

💻 使用例

基本的な使用法

• 検索機能：

  • 質問例：「Genius上でTaylor Swiftの曲を検索して。」
  • Claudeが自動的にgenius - searchツールを呼び出して検索を実行します。

• 詳細情報の取得：

  • 曲IDによる検索：/genius - song?songId = 123456
  • アーティストIDによる検索：/genius - artist?artistId = 789012

🔧 開発と貢献

ローカル開発

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

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

2. 依存関係をインストールし、開発サーバーを起動します。

   npm install && npm run dev
   

貢献ガイド

どんな貢献も歓迎します！GitHubリポジトリを通じてIssueまたはPull Requestを提出し、機能要求や問題の修正を提案してください。

📄 ライセンス

このプロジェクトはISCライセンスに従います。具体的な内容は以下の通りです。

ISC License

Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.