원클릭 설치
Cursor와 Replit의 경우 아래 버튼을 클릭하세요:
기타 MCP 클라이언트
다른 MCP 호환 클라이언트의 경우 이 URL을 추가하세요:
https://typecast.ai/docs/mcp
claude mcp add typecast-helper https://typecast.ai/docs/mcp
- Windsurf 설정 열기
- Cascade → MCP Servers로 이동
- “Add Server” → “Add Remote MCP Server” 클릭
- URL 입력:
https://typecast.ai/docs/mcp
.vscode/mcp.json에 추가하세요:{
"servers": {
"typecast-helper": {
"url": "https://typecast.ai/docs/mcp"
}
}
}
활용 방법
연결되면 AI 어시스턴트가 다음에 대한 지식을 얻습니다:
- API 통합 — 모든 언어에 대한 코드 예제 얻기
- 캐릭터 선택 — 용도에 맞는 완벽한 캐릭터 찾기
- 모범 사례 — 다양한 시나리오에 대한 최적의 설정 배우기
- 문제 해결 — 일반적인 문제에 대한 빠른 해결책
"내 프로젝트에 Typecast TTS를 통합해줘."
위 설정이 필요한 전부입니다. 아래 섹션은 고급 사용 사례를 위한 선택 사항입니다.
고급: 자동 TTS 생성
자동으로 오디오 파일을 생성해야 하나요? 타입캐스트 자체 호스팅 MCP 서버를 사용하면 AI 어시스턴트가 타입캐스트 API를 직접 호출하여 필요에 따라 오디오를 생성할 수 있습니다. 배치 처리 및 자동화 워크플로우에 완벽합니다.
차별점
| URL 기반 MCP | 자체 호스팅 MCP 서버 |
|---|
| 지식 및 가이드 제공 | 실제로 오디오 파일 생성 |
| API 호출 없음 | 타입캐스트 API를 직접 호출 |
| 학습 및 통합 도움에 좋음 | 자동화 및 배치 작업에 좋음 |
사전 준비 사항
Claude Desktop (macOS)
Claude Desktop (Windows)
Claude Desktop (Linux)
Cursor
Claude Code
~/Library/Application Support/Claude/claude_desktop_config.json 편집:{
"mcpServers": {
"typecast": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/neosapience/typecast-api-mcp-server.git",
"typecast-api-mcp-server"
],
"env": {
"TYPECAST_API_KEY": "YOUR_API_KEY",
"TYPECAST_OUTPUT_DIR": "/Users/yourname/Downloads/typecast_output"
}
}
}
}
%APPDATA%\Claude\claude_desktop_config.json 편집:{
"mcpServers": {
"typecast": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/neosapience/typecast-api-mcp-server.git",
"typecast-api-mcp-server"
],
"env": {
"TYPECAST_API_KEY": "YOUR_API_KEY",
"TYPECAST_OUTPUT_DIR": "C:\\Users\\yourname\\Downloads\\typecast_output"
}
}
}
}
~/.config/Claude/claude_desktop_config.json 편집:{
"mcpServers": {
"typecast": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/neosapience/typecast-api-mcp-server.git",
"typecast-api-mcp-server"
],
"env": {
"TYPECAST_API_KEY": "YOUR_API_KEY",
"TYPECAST_OUTPUT_DIR": "/home/yourname/Downloads/typecast_output",
"XDG_RUNTIME_DIR": "/run/user/1000"
}
}
}
}
Linux에서는 오디오 재생을 위해 XDG_RUNTIME_DIR이 필요합니다.
Cursor의 MCP 설정에 추가하세요:{
"mcpServers": {
"typecast": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/neosapience/typecast-api-mcp-server.git",
"typecast-api-mcp-server"
],
"env": {
"TYPECAST_API_KEY": "YOUR_API_KEY",
"TYPECAST_OUTPUT_DIR": "/path/to/output"
}
}
}
}
# Typecast MCP 서버 추가
claude mcp add typecast \
--command "uvx --from git+https://github.com/neosapience/typecast-api-mcp-server.git typecast-api-mcp-server" \
--env TYPECAST_API_KEY=YOUR_API_KEY \
--env TYPECAST_OUTPUT_DIR=/path/to/output
문제 해결
- 구성이 올바른지 확인하세요
- 애플리케이션을 완전히 다시 시작하세요
uv가 설치되어 있고 PATH에서 사용 가능한지 확인하세요
- API 키가 구성에 올바르게 설정되어 있는지 확인하세요
- 타입캐스트 API에서 키를 확인하세요
XDG_RUNTIME_DIR 환경 변수를 설정하세요- 오디오 장치 확인:
aplay -l
참고 자료
