Hanzo

🚀 漢佐 MCP プロジェクトガイド

このプロジェクトは、Hanzo MCP の使用方法を提供し、必要なインストールと設定手順を含んでいます。また、基本的な操作や機能の概要も紹介しています。

🚀 クイックスタート

Hanzo MCP をすぐに使い始めるには、以下の手順に従ってください。

📦 インストール

依存関係のインストール

Hanzo MCP を使用するには、まず必要な Python パッケージをインストールする必要があります。

pip install hanzo-mcp

追加機能（ベクトルストレージなど）が必要な場合は、以下の依存関係を必要に応じて追加してください。

• VoyageAI サポート：

  pip install voyageai
  

• SentenceTransformer サポート：

  pip install hanzo-mcp[vector,sentencetransformer]
  

環境変数の設定

選択した埋め込みプロバイダに応じて、対応する環境変数を設定してください。

• VoyageAI：
  • 設定変数：VOYAGE_API_KEY または CHROMA_VOYAGE_API_KEY
• OpenAI：
  • 設定変数：OPENAI_API_KEY または CHROMA_OPENAI_API_KEY
• Anthropic：
  • 設定変数：ANTHROPIC_API_KEY または CHROMA_ANTHROPIC_API_KEY

💻 使用例

基本的な使用法

MCP サービスの初期化

import asyncio
from hanzo_mcp.mcp_server import HanzoMCP

async def main():
    # Hanzo MCP インスタンスを作成
    mcp = HanzoMCP(
        allowed_paths=["/path/to/project"],
        embedding_provider="voyage"  # サポート: 'openai', 'anthropic', 'sentence_transformer'
    )

    # サービスを起動
    await mcp.start()

# メイン関数を実行
if __name__ == "__main__":
    asyncio.run(main())

高度な使用法

1. ファイルインデックス

指定されたディレクトリ内のファイルを意味的にインデックス化します。

result = await dev(
    ctx,
    operation="vector_index",
    path="/path/to/project",
    recursive=True,
    file_pattern="*.py"  # オプション: Python ファイルのみをインデックス化
)

2. 意味検索

自然言語でコードベースを検索します。

result = await dev(
    ctx,
    operation="vector_search",

✨ 主な機能

基本操作

• ファイルインデックス：指定されたディレクトリ内のファイルを意味的にインデックス化します。
• 意味検索：自然言語でコードベースを検索できます。