Phrases

🚀 🤖 フレーズ MCP サーバー

このサーバーは、励ましのフレーズを管理するための、エレガントで効率的なフレーズ MCP サーバーです。デスクトップ版 Claude やその他の MCP クライアントとシームレスに統合するように設計されています。

✨ 主な機能

• 完全なフレーズ管理 - フレーズの作成、読み取り、更新、削除を簡単に行えます。
• デスクトップ版 Claude との統合 - デスクトップ版 Claude から直接フレーズとやり取りできます。
• 組み込みのモック API - テストや開発にモック API を使用できます。

🛠️ 利用可能なツール

🔧 技術詳細

📦 インストール

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

git clone https://github.com/ronniemh/phrases-MCP-server.git

2. 依存関係をインストールします。

npm install

3. サーバーを起動します。

node index.js

🛠️ デスクトップ版 Claude との設定

手順説明

1. 設定ファイルのコピー：config.json をプロジェクトのルートディレクトリにコピーします。
2. 設定ファイルの編集：必要に応じて API アドレスやその他のパラメータを変更します。
3. サーバーの再起動：設定を完了したら、MCP サービスを再起動します。

サンプルパス

Windows：%UserProfile%\.claude\config.json
MacOS と Linux：~/.claude/config.json

💻 使用例

デスクトップ版 Claude では、以下のコマンドを実行してフレーズマネージャーとやり取りできます。

基本的な使用法

POST /api/v1/phrases HTTP/1.1
Content-Type: application/json

{
  "phrase": "あなたの励ましのフレーズ"
}

📋 テストについて

注意事項

テストを行う前に、tsconfig.json ファイルの以下の部分を変更してください。

// この部分をテスト環境に合わせて変更します
const BASE_URL = "https://mockapi.io/your-project/user";

📁 プロジェクト構造

• src/：すべてのソースコードファイルが含まれています。
• public/：画像やスタイルシートなどの公共のアセットが格納されています。
• config.json：プロジェクトの設定ファイルです。

📋 開発フロー

ワークフローの説明

1. コーディング段階：
   • コア機能を記述します。
   • デスクトップ版 Claude とのやり取りロジックを実装します。
2. テスト段階：
   • 単体テストを実行します。
   • API リクエストが正しく動作することを確認します。
3. デプロイ段階：
   • コードをリポジトリにコミットします。
   • 本番環境にプッシュします。

🛠️ MockAPI の設定

独自のインスタンスを作成する

1. MockAPI アカウントに登録します。
2. 新しいプロジェクトを作成し、user リソースを追加します。以下のフィールドを含めます。
   • id（数値、自動生成）
   • name（文字列）
   • phrase（文字列）
3. src/helpers/makeMockAPIRequest.ts の BASE_URL 値を取得して置き換えます。

📝 注意事項

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

📄 ライセンス

ISC