Neosapience Typecast Api MCP Server Sample

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

このプロジェクトは、Typecast APIに対するMCP（モデルコンテキストプロトコル）サーバーを実装し、MCPクライアントへのシームレスな統合をサポートします。モデルコンテキストプロトコルを通じてTypecast APIとやり取りするための標準化された方法を提供します。

🚀 クイックスタート

このプロジェクトは、Typecast APIのモデルコンテキストプロトコルのサーバー側を実装しており、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

🤝 貢献

どんな形の貢献も大歓迎です！ぜひPull Requestを提出してください。

📄 ライセンス

MIT License