워드웨어-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 서버를 시작할 수 있습니다.
영구 설치
패키지를 영구적으로 설치하려면 다음을 수행하세요.
필수 조건
이 패키지를 사용하려면 다음이 필요합니다.
- Wordware 계정( wordware.ai 에서 가입)
- Wordware API 키
- 최소 하나 이상의 배포된 Wordware 앱
기본 사용법
npx를 직접 사용(설치 필요 없음)
npx를 먼저 설치하지 않고도 wordware-mcp를 실행할 수 있습니다.
글로벌 명령으로서
글로벌하게 설치한 경우 다음 두 가지 방법 중 하나로 실행할 수 있습니다.
명령줄 옵션
프로젝트의 패키지로
구성
MCP 서버는 두 가지 방법으로 구성할 수 있습니다.
1. 환경 변수 또는 .env 파일
다음 변수를 사용하여 .env
파일을 만듭니다.
2. 명령줄 인수
명령을 실행할 때 구성을 직접 전달하세요.
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 데스크톱 구성 파일을 수정하세요.- 파일에 다음을 추가합니다.
전체 예제 워크플로
빠르게 시작하고 실행할 수 있는 전체 워크플로우 예는 다음과 같습니다.
1. Wordware MCP 구성 및 시작
2. 애플리케이션과 통합
MCP 서버를 시작하면 다음 위치에서 Wordware 앱에 액세스할 수 있습니다.
HTTP 요청을 통해 Wordware 흐름을 트리거할 수 있습니다.
3. 핫 리로딩을 이용한 개발
개발 중에 Wordware 앱에 가한 모든 변경 사항은 즉시 적용할 수 있습니다. 앱을 새로 고치거나 새로운 API 호출을 하면 됩니다.
개발
이 패키지에 기여하고 싶다면:
특허
MIT
문제 해결
npx의 일반적인 문제
- 설치 후 "명령을 찾을 수 없습니다"npx로 설치한 후
command not found
표시되는 경우: - 구성 문제구성이 감지되지 않는 경우:
- 연결 거부 오류앱을 사용하려고 할 때 연결 오류가 발생하는 경우:
- 권한 문제npx에서 권한 오류가 발생하는 경우:
추가 지원이 필요하면 GitHub 저장소에 문제를 제출하세요.
환경 변수
다음 환경 변수는 .env
파일에서 설정할 수 있습니다.
PORT
- 서버를 실행할 포트(기본값: 3000)WORDWARE_API_KEY
- Wordware API 키
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
개발자가 Wordware AI 흐름을 로컬에서 실행할 수 있도록 하는 마스터 제어 프로그램 서버로, Wordware의 AI 기능을 로컬 개발 환경에 직접 통합할 수 있습니다.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server that bridges AI assistants like Claude with Wordware's specialized agent capabilities, allowing dynamic loading and access to any Wordware flow through a standardized interface.Last updated -Python
- AsecurityFlicenseAqualityAn MCP server that supercharges AI assistants with powerful tools for software development, enabling research, planning, code generation, and project scaffolding through natural language interaction.Last updated -116462TypeScript
- AsecurityFlicenseAqualityAn AI-powered MCP server that enables natural language interaction with AO (Arweave Operating system) for creating, running, and testing code and handlers without manual coding.Last updated -14886,0893TypeScript
- AsecurityAlicenseAqualityA MCP server that enables human-in-the-loop workflow in AI-assisted development tools by allowing users to run commands, view their output, and provide textual feedback directly to the AI assistant.Last updated -11,461PythonMIT License