워드웨어-mcp
Wordware MCP(Model Context Protocol) 서버를 사용하면 Wordware 앱을 로컬에서 실행할 수 있습니다. 이를 통해 Wordware의 강력한 AI 흐름을 로컬 개발 환경에 직접 통합할 수 있으므로 Wordware 기능을 활용하는 애플리케이션을 더욱 쉽게 테스트하고 개발할 수 있습니다.
버전 1.1.5의 새로운 기능
- 새로운 로컬 API 엔드포인트( http://localhost:9000/{WORDWARE\_API\_TOKEN} )와 작동하도록 업데이트되었습니다.
- 더 이상 APP_ID를 지정할 필요가 없습니다. 도구가 자동으로 검색됩니다.
npx wordware-mcp 이용한 대화형 설치 과정- 자동 Claude 구성 설정
- 명령줄 인수 지원을 통한 향상된 CLI 인터페이스
- 매개변수를 통한 API 키 직접 지정
- 향상된 오류 처리 및 로깅
- 간단한 명령 구문을 통한 글로벌 설치 지원
설치
시작하는 가장 쉬운 방법은 npx를 사용하여 대화형 설치 프로세스를 사용하는 것입니다.
지엑스피1
이 가이드는 다음을 안내합니다.
- Wordware API 키 입력
- Claude 구성 설정(선택 사항)
npx 명령어는 다음을 수행합니다.
- 제공되지 않으면 구성 세부 정보를 입력하라는 메시지가 표시됩니다.
- 필요한 구성 파일을 만듭니다
- Wordware 앱을 실행하기 위한 로컬 환경 설정
npx 명령을 실행한 후 다음을 사용하여 MCP 서버를 시작할 수 있습니다.
영구 설치
패키지를 영구적으로 설치하려면 다음을 수행하세요.
# Install globally from npm registry
npm install -g wordware-mcp
# Or install locally in your project
npm install wordware-mcp
# Or clone this repository and install globally
git clone https://github.com/{username}/wordware-mcp.git
cd wordware-mcp
npm run install-global
필수 조건
이 패키지를 사용하려면 다음이 필요합니다.
- Wordware 계정( wordware.ai 에서 가입)
- Wordware API 키
- 최소 하나 이상의 배포된 Wordware 앱
기본 사용법
npx를 직접 사용(설치 필요 없음)
npx를 먼저 설치하지 않고도 wordware-mcp를 실행할 수 있습니다.
# Interactive mode - will prompt for required information
npx wordware-mcp
# Or with command line parameters
npx wordware-mcp --api-key your-api-key --port 3000
# Start MCP server after configuration
npx wordware-mcp start
글로벌 명령으로서
글로벌하게 설치한 경우 다음 두 가지 방법 중 하나로 실행할 수 있습니다.
# Option 1: Create an .env file in your current directory first (see Configuration section)
wordware-mcp
# Option 2: Pass parameters directly via command line
wordware-mcp --api-key your-api-key --port 3000
명령줄 옵션
Options:
--api-key, -k <key> Wordware API key (required unless in .env file)
--port, -p <port> Port to run the server on (default: 3000)
--help, -h Show this help message
프로젝트의 패키지로
// In your script
import { startMCP } from "wordware-mcp";
// Start the MCP server
startMCP();
구성
MCP 서버는 두 가지 방법으로 구성할 수 있습니다.
1. 환경 변수 또는 .env 파일
다음 변수를 사용하여 .env 파일을 만듭니다.
WORDWARE_API_KEY=your-api-key
PORT=3000
2. 명령줄 인수
명령을 실행할 때 구성을 직접 전달하세요.
wordware-mcp -k your-api-key -p 3000
Wordware 설정 만들기
계정을 생성하세요
시작하려면 Wordware 계정이 필요합니다. wordware.ai 로 이동하여 로그인하고 계정을 만드세요.
API 키 생성
MCP를 통해 워드웨어 플로우에 접근하려면 API 키를 생성해야 합니다. 오른쪽 상단의 프로필 사진 > API 키 > 새 키 생성 > 키 복사를 클릭하세요.
앱 만들기
이제 창의력을 발휘할 시간입니다. 원하는 것을 구현할 수 있는 워드웨어 앱을 직접 만들어 보세요. 아니면 탐색 페이지( https://app.wordware.ai/explore )에서 앱을 포크해서 사용해도 됩니다.
앱 배포
앱을 MCP로 실행하려면 먼저 배포해야 합니다. 배포하려면 앱으로 이동하세요. 오른쪽 상단에 "배포" 버튼이 보일 것입니다. 그런 다음 배포 페이지로 이동하세요.
app_id 를 받으세요
배포 페이지에 배포 URL( https://app.wordware.ai/explore/apps/{app_id} 이 표시됩니다. 여기에서 app_id를 확인하세요.
Claude Desktop과 함께 사용
Claude Desktop과 함께 이 MCP 서버를 사용하려면:
- Claude for Desktop이 설치되어 있는지 확인하세요.
~/Library/Application\ Support/Claude/claude_desktop_config.json 에 있는 Claude 데스크톱 구성 파일을 수정하세요.- 파일에 다음을 추가합니다.
{
"mcpServers": {
"wordware": {
"command": "wordware-mcp"
}
}
}
전체 예제 워크플로
빠르게 시작하고 실행할 수 있는 전체 워크플로우 예는 다음과 같습니다.
1. Wordware MCP 구성 및 시작
# Run the interactive setup
npx wordware-mcp
# Follow the prompts to:
# - Enter your Wordware API key
# - Configure Claude integration (if desired)
# Once configured, start the server
npx wordware-mcp start
2. 애플리케이션과 통합
MCP 서버를 시작하면 다음 위치에서 Wordware 앱에 액세스할 수 있습니다.
http://localhost:3000/api/run/{app_id}
HTTP 요청을 통해 Wordware 흐름을 트리거할 수 있습니다.
// Example: Calling your Wordware app from JavaScript
async function callWordwareApp() {
const response = await fetch("http://localhost:3000/api/run/your-app-id", {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify({
// Your input data here
prompt: "Your prompt to the AI model",
// Any other parameters your Wordware app expects
}),
});
const result = await response.json();
console.log(result);
}
3. 핫 리로딩을 이용한 개발
개발 중에 Wordware 앱에 가한 모든 변경 사항은 즉시 적용할 수 있습니다. 앱을 새로 고치거나 새로운 API 호출을 하면 됩니다.
개발
이 패키지에 기여하고 싶다면:
# Clone the repository
git clone https://github.com/yuhuangou/wordware-mcp.git
cd wordware-mcp
# Install dependencies
npm install
# Build the package
npm run build
# Run in development mode
npm run dev
특허
MIT
문제 해결
npx의 일반적인 문제
- 설치 후 "명령을 찾을 수 없습니다"npx로 설치한 후
command not found 표시되는 경우:# Make sure the package is installed globally
npm install -g wordware-mcp
# Check your npm global path is in your PATH
npm config get prefix
# Add the resulting path + /bin to your PATH if needed
- 구성 문제구성이 감지되지 않는 경우:
# Check if .env file exists in current directory
ls -la .env
# Manually run with parameters to bypass .env
npx wordware-mcp --api-key your-api-key
- 연결 거부 오류앱을 사용하려고 할 때 연결 오류가 발생하는 경우:
# Check if server is running
lsof -i :3000
# Restart server with verbose logging
npx wordware-mcp start --verbose
- 권한 문제npx에서 권한 오류가 발생하는 경우:
# Run with sudo (not recommended as permanent solution)
sudo npx wordware-mcp
# Fix npm permissions
chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}
추가 지원이 필요하면 GitHub 저장소에 문제를 제출하세요.
환경 변수
다음 환경 변수는 .env 파일에서 설정할 수 있습니다.
PORT - 서버를 실행할 포트(기본값: 3000)WORDWARE_API_KEY - Wordware API 키