워드웨어-mcp

Wordware MCP(마스터 제어 프로그램) 서버를 사용하면 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 서버를 시작할 수 있습니다.

npx wordware-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/yuhuangou/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 키

Integrations