🤖 Phrases MCP Server

🤖 Phrases MCP Server

心に響くフレーズを管理するための、洗練された効率的な MCP（Model Context Protocol）サーバーです。Claude for Desktop やその他の MCP クライアントとシームレスに連携できるよう設計されています。

✨ 特徴

• フレーズを包括的に管理 - フレーズの作成、読み取り、更新、削除を簡単に行えます
• Claude for Desktop との連携 - Claude からフレーズを直接操作できます
• Mock API を内蔵 - テストや開発に Mock API を利用できます

🛠️ 利用可能なツール

いいえ サーバーは次の MCP ツールを公開します。

ツール	説明
get-all-phrases	利用可能なすべてのフレーズを取得します
get-phrase-by-id	ID でフレーズを検索します
get-phrase-by-name	作者名でフレーズを検索します
create-phrase	新しいフレーズを作成します
update-phrase	既存のフレーズのテキストを更新します
delete-phrase	ID でフレーズを削除します

🚀 インストール

# Clonar el repositorio
git clone https://github.com/ronniemh/phrases-MCP-server.git
cd phrases-MCP-server

# Instalar dependencias
npm install

# Compilar el proyecto
npm run build

🔌 Claude for Desktop の設定

1. Claude for Desktop をインストールします（最新バージョンを使用してください）

2. この MCP サーバーを使用するよう Claude for Desktop を設定します：

   設定ファイルを開きます（Mac/Linux）：

   ~/Library/Application Support/Claude/claude_desktop_config.json
   

3. サーバーの設定を追加します：

   {
       "mcpServers": {
           "phrases": {
               "command": "node",
               "args": [
                   "/RUTA_ABSOLUTA_A/phrases/build/index.js"
               ]
           }
       }
   }
   

4. Claude for Desktop を再起動します

💡 Claude での使用方法

設定が完了すると、Claude for Desktop からフレーズを直接操作できます：

• 「利用可能なすべてのフレーズを表示して」
• 「[作者名] のフレーズを検索して」
• 「[名前] 向けに、[テキスト] と書かれた新しいフレーズを作成して」
• 「ID [番号] のフレーズを [新しいテキスト] に更新して」
• 「ID [番号] のフレーズを削除して」

🧪 テスト

⚠️ 重要：テスト用の設定

テストを実行する前に、tsconfig.json ファイルを一時的に変更する必要があります。compilerOptions セクションを次のように変更してください：

"compilerOptions": {
  "target": "ES2020",
  "module": "NodeNext",
  "moduleResolution": "NodeNext",
  "esModuleInterop": true,
  "outDir": "build",
  "strict": true
}

注：MCP サーバーを正しくコンパイルできるよう、テスト後に元の設定に戻すことを忘れないでください。

テストを実行するには：

npm run test:requests

このコマンドは、Mock API を使用してフレーズを作成、読み取り、更新、削除する一連のテストを実行します。

🏗️ プロジェクト構成

src/
├── helpers/
│   └── makeMockAPIRequest.ts  # Funciones de ayuda para interactuar con la API
├── index.ts                   # Punto de entrada principal y definición de herramientas
└── testRequest.ts             # Script para probar las funciones de la API

🔄 開発ワークフロー

1. src/ のコードを変更します
2. npm run build でコンパイルします
3. npm run test:requests でテストします
4. 変更を適用するため、Claude for Desktop を再起動します

🔍 MockAPI の設定

このプロジェクトでは、フレーズを保存および管理するバックエンドとして MockAPI を使用します。設定されているベース URL は次のとおりです：

https://67ec86aeaa794fb3222e0682.mockapi.io/frases/api/v1/user

独自の MockAPI インスタンスを設定する

1. MockAPI でアカウントを作成します
2. 新しいプロジェクトを作成します
3. 次のフィールドを含む user というリソースを作成します：
   • id（number、自動生成）
   • name（string）
   • phrase（string）
4. API の URL をコピーします
5. src/helpers/makeMockAPIRequest.ts ファイルの BASE_URL 定数を更新します

// Cambia esta línea con tu propia URL de MockAPI
const BASE_URL = "https://tu-proyecto.mockapi.io/tu-path/user";

📝 追加の注意事項

• このサーバーはデータの保存に Mock API を使用します。本番環境では、実際のデータベースの導入を検討してください。
• プロジェクトの保守性を高めるため、MCP の公式ガイドラインに沿った構成になっています。
• Mock API で問題が発生した場合は、MockAPI の無料利用枠の制限を確認してください。

📄 ライセンス

ISC