Typecast Api MCP Server Sample

🚀 タイプキャストAPI - MCPサーバーサンプル

Typecast API用のMCPサーバーを実装し、MCPクライアントとのシームレスな統合をサポートします。このプロジェクトは、Model Context Protocolを通じてTypecast APIと相互作用する標準的な方法を提供します。

🚀 クイックスタート

このプロジェクトでは、Typecast APIのModel コンテキストプロトコルサーバーを実装しており、MCPクライアントが標準化された方法でTypecast APIとやり取りできるようになっています。

✨ 主な機能

📦 インストール

Gitクローン

git clone https://github.com/hyunseung/typecast-api-mcp-server-sample.git
cd typecast-api-mcp-server-sample

依存関係

このプロジェクトにはPython 3.10以上が必要で、パッケージ管理にuvを使用します。

パッケージのインストール

# 仮想環境を作成し、パッケージをインストールする
uv venv
uv pip install -e .

環境変数

以下の環境変数を設定してください。

TYPECAST_API_HOST=https://api.typecast.ai
TYPECAST_API_KEY=<your-api-key>
TYPECAST_OUTPUT_DIR=<your-output-directory> # デフォルト：~/Downloads/typecast_output

Claude Desktopとの併用

claude_desktop_config.jsonに以下の内容を追加できます。

基本設定：

{
  "mcpServers": {
    "typecast-api-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/PATH/TO/YOUR/PROJECT",
        "run",
        "typecast-api-mcp-server"
      ],
      "env": {
        "TYPECAST_API_HOST": "https://api.typecast.ai",
        "TYPECAST_API_KEY": "YOUR_API_KEY",
        "TYPECAST_OUTPUT_DIR": "PATH/TO/YOUR/OUTPUT/DIR"
      }
    }
  }
}

/PATH/TO/YOUR/PROJECTを実際のプロジェクトのパスに置き換えてください。

手動実行

サーバーを手動で実行することもできます。

uv run python app/main.py

🤝 貢献

いかなる貢献も大歓迎です！プルリクエストをいつでも送信してください。

📄 ライセンス

MITライセンス