Fluorite MCP

日本語

English

日本語

English

ダークモード

よくある質問（FAQ） ​

Fluorite MCPに関するよくある質問と回答をまとめています。

📦 インストール関連 ​

Q: Node.jsの最小要件は何ですか？ ​

A: Node.js 18.0以上が必要です。最高のパフォーマンスを得るために、Node.js 20.0以上を推奨します。

bash
# Node.jsバージョンの確認
node --version

Q: グローバルインストールとローカルインストールの違いは何ですか？ ​

A: グローバルインストール（推奨）は、システム全体でFluorite MCPを使用できます。ローカルインストールは特定のプロジェクトのみで使用する場合に適しています。

bash
# グローバルインストール（推奨）
npm install -g fluorite-mcp

# ローカルインストール
npm install fluorite-mcp

Q: Claude Code CLIとの統合が失敗する場合はどうすればよいですか？ ​

A: 以下の手順を試してください：

  1. Claude Code CLIが最新バージョンであることを確認
  2. Fluorite MCPを再インストール
  3. MCPサーバーリストを確認
bash
# 再インストール
npm uninstall -g fluorite-mcp
npm install -g fluorite-mcp

# MCPサーバーの確認
claude mcp list

🛠️ 使用方法関連 ​

Q: /fl: コマンドと通常のコマンドの違いは何ですか？ ​

A: /fl: プレフィックスはFluorite MCPの拡張コマンドを示します。これらのコマンドは：

  • スパイクテンプレートの自動選択
  • トークン最適化
  • 自然言語処理の強化
  • 継続的学習機能の活用

Q: スパイクテンプレートとは何ですか？ ​

A: スパイクテンプレートは、特定のタスクや機能を迅速に実装するための事前定義されたコードパターンです。6,200以上のテンプレートが含まれており、認証、API、テスト、デプロイメントなど様々な用途に対応しています。

Q: UI生成コマンド（/fl:ui）はどのように動作しますか？ ​

A: UI生成コマンドは以下のプロセスで動作します：

  1. 自然言語でコンポーネントの要件を解析
  2. 21st.devデータベースからマッチするパターンを検索
  3. フレームワーク固有のコードを生成
  4. TypeScript定義、アクセシビリティ、エラーハンドリングを含む
bash
# 使用例
/fl:ui "Create a responsive navigation menu with dark mode support"

🔍 静的解析関連 ​

Q: 静的解析はどのフレームワークに対応していますか？ ​

A: 現在対応しているフレームワーク：

  • Next.js
  • React
  • Vue
  • TypeScript（すべてのフレームワーク共通）

Q: カスタム検証ルールを追加できますか？ ​

A: はい、カスタムルールを追加できます。src/analysis/rules/ ディレクトリに新しいルールファイルを作成してください。

🧠 メモリエンジン関連 ​

Q: メモリエンジンはどのようなデータを学習しますか？ ​

A: メモリエンジンは以下を学習します：

  • 技術ドキュメンテーション
  • 成功したコード生成パターン
  • エラーパターンとその解決策
  • プロジェクト固有の慣習

Q: 学習データはどこに保存されますか？ ​

A: 学習データは.fluorite/memory/ ディレクトリにチャンク形式で保存されます。プライバシーとセキュリティを考慮し、暗号化されています。

🤝 貢献関連 ​

Q: 新しいスパイクテンプレートを貢献する方法は？ ​

A: 以下の手順で貢献できます：

  1. リポジトリをフォーク
  2. src/spikes/ に新しいテンプレートファイルを作成
  3. テストとドキュメンテーションを追加
  4. プルリクエストを送信

詳細はテンプレート作成ガイドを参照してください。

Q: ライブラリ仕様を追加する方法は？ ​

A: src/catalog/ ディレクトリにYAMLファイルを追加し、プルリクエストを送信してください。貢献ガイドに詳細な手順があります。

⚡ パフォーマンス関連 ​

Q: トークン使用量を最適化する方法は？ ​

A: 以下の方法で最適化できます：

  • --uc フラグを使用して超圧縮モードを有効化
  • 具体的なコンテキストを提供して不要な生成を避ける
  • スパイクテンプレートを活用して定型コードを削減

Q: 大規模プロジェクトでのパフォーマンスを改善する方法は？ ​

A: 推奨される最適化：

  1. キャッシュの有効活用（自動）
  2. 並列処理の活用（--delegate フラグ）
  3. Waveモードの使用（複雑な操作時）

🔧 トラブルシューティング関連 ​

Q: ENOENT エラーが発生する場合は？ ​

A: ファイルやディレクトリが見つからないエラーです。以下を確認してください：

  • Fluorite MCPが正しくインストールされているか
  • 必要なディレクトリの権限が適切か
bash
# 再インストール
npm install -g fluorite-mcp

Q: MCPサーバーが起動しない場合は？ ​

A: 以下を確認してください：

  1. ポートが他のプロセスで使用されていないか
  2. Node.jsのバージョンが要件を満たしているか
  3. ログファイルでエラーの詳細を確認
bash
# プロセスの確認
ps aux | grep fluorite
# ログの確認
tail -f ~/.fluorite/logs/server.log

🌐 言語サポート関連 ​

Q: 日本語以外の言語はサポートされていますか？ ​

A: ドキュメンテーションは日本語と英語で提供されています。コード生成とスパイクテンプレートは多言語対応しており、コメントやドキュメンテーションを指定した言語で生成できます。

Q: スピーチ処理機能はどの言語に対応していますか？ ​

A: X-SAMPA/IPA変換により、多言語の音声分析が可能です。現在対応している主な言語：

  • 日本語
  • 英語
  • 中国語
  • スペイン語
  • フランス語

📚 その他 ​

Q: Fluorite MCPの名前の由来は？ ​

A: Fluorite（蛍石）は美しく多彩な色を持つ鉱物です。このプロジェクトが開発者の創造性を多様に輝かせることを願って名付けられました。

Q: エンタープライズサポートは利用可能ですか？ ​

A: 現在、コミュニティサポートのみ提供しています。商用サポートについてはGitHubディスカッションでお問い合わせください。

Q: ライセンスは何ですか？ ​

A: Fluorite MCPはMITライセンスの下で提供されています。商用利用も可能です。

📧 さらなるサポート ​

質問が解決しない場合は、以下のチャンネルをご利用ください：

  • GitHub Issues: バグ報告や機能リクエスト
  • GitHub Discussions: 一般的な質問やディスカッション
  • ドキュメント: 完全なドキュメントを参照

最終更新日: 2024

Released under the MIT License.

Copyright © 2024-present Fluorite MCP Contributors