Neosapience Typecast Api MCP Server Sample

🚀 類型轉換API-MCP服務器示例

本項目為Typecast API實現了MCP（模型上下文協議）服務器，可無縫集成到MCP客戶端。它提供了標準化方式，能通過Model Context Protocol與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