🤖 フレーズ MCP サーバー

インスピレーションを与える引用を管理するための、エレガントで効率的な MCP (Model Context Protocol) サーバー。 Claude for Desktop およびその他の MCP クライアントとシームレスに統合するように設計されています。

✨ 特徴

完全なフレーズ管理- フレーズを簡単に作成、読み取り、更新、削除できます
Claude for Desktop Integration - Claudeから直接フレーズを操作
統合されたモックAPI - テストと開発にモック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のセットアップ

Claude for Desktopをインストールします (最新バージョンであることを確認してください)
この MCP サーバーを使用するように Claude for Desktop を構成します。次の場所にある構成ファイル (MAC/Linux) を開きます。
~/Library/Application Support/Claude/claude_desktop_config.json
サーバー構成を追加します:
{ "mcpServers": { "phrases": { "command": "node", "args": [ "/RUTA_ABSOLUTA_A/phrases/build/index.js" ] } } }
デスクトップ版の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

このコマンドは、モック 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

🔄開発ワークフロー

src/のコードを修正する
npm run buildでコンパイルする
npm run test:requestsでテストする
変更を適用するには、Claude for Desktopを再起動してください。

🔍 MockAPI 構成

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

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

独自のMockAPIインスタンスの設定

MockAPIでアカウントを作成する
新しいプロジェクトを作成する
次のフィールドを持つuserというリソースを作成します。
- id （数値、自動生成）
- name （文字列）
- phrase （文字列）
API URLをコピーする
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";

📝 追加情報

このサーバーは、データを保存するためにモック API を使用します。実稼働環境では、実際のデータベースを実装することを検討してください。
プロジェクト構造は、保守性を向上させるために公式の MCP ガイドラインに従っています。
Mock API で問題が発生した場合は、MockAPI の無料使用制限を確認してください。

📄 ライセンス

ISC

Phrases MCP Server