Integrations
Uses environment variables for configuration and authentication with Wordware API credentials
워드웨어 MCP
Wordware의 강력한 에이전트 기능을 Claude 및 기타 MCP 호환 AI 어시스턴트와 통합하는 MCP(Model Context Protocol) 서버입니다.
개요
이 프로젝트는 Anthropic의 모델 컨텍스트 프로토콜(MCP)을 통해 Claude와 같은 AI 어시스턴트와 Wordware의 특수 에이전트 기능을 연결합니다. 이 통합은 구성에 따라 Wordware API에서 도구를 동적으로 로드하여 Claude가 모든 특수 Wordware 흐름에 접근할 수 있도록 합니다.
특징
- 🔄 동적 도구 로딩 - 구성에 따라 Wordware API에서 도구를 자동으로 로드합니다.
- 🧠 지능형 스키마 감지 - 다양한 도구 입력 스키마를 자동으로 감지하고 이에 적응합니다.
- 🔍 고급 매개변수 처리 - 다양한 입력 형식(JSON, 중첩 구조, 문자열) 처리
- ⚙️ 강력한 오류 처리 - 포괄적인 오류 로깅 및 이벤트 루프 관리
- 🔑 간단한 인증 - Wordware 계정을 연결하기 위한 간편한 설정
필수 조건
- 파이썬 3.8 이상
- Wordware API 자격 증명
- Claude Desktop 또는 기타 MCP 호환 클라이언트
설치
지엑스피1
구성
다음 구조의 tools_config.json 파일을 만듭니다.
이 구성 파일에서 Wordware 도구 ID를 지정할 수 있으며, 서버는 해당 도구를 동적으로 로드하여 MCP 도구로 등록합니다. 입력 스키마와 설명을 포함한 도구 메타데이터는 Wordware API에서 직접 가져옵니다.
사용자 정의 구성 파일 경로를 지정하려면 CONFIG_PATH 환경 변수를 사용합니다.
서버 실행
작동 원리
Wordware MCP 서버는 다음과 같이 작동합니다.
- 도구 구성 로딩 - 구성 파일에서 도구 ID 목록을 읽습니다.
- 동적 도구 등록 - 각 도구 ID에 대해:
- Wordware API에서 메타데이터를 가져옵니다.
- 입력 스키마 요구 사항을 감지합니다.
- 해당 MCP 도구 기능을 생성합니다.
- MCP 서버에 도구를 등록합니다.
- 요청 처리 - 도구가 호출될 때:
- 다양한 형식(JSON 객체, 문자열, 중첩 구조)의 입력 매개변수를 처리합니다.
- 도구 요구 사항에 따라 매개변수 형식을 조정합니다.
- 올바르게 포맷된 요청을 Wordware API로 보냅니다.
- 응답 처리 - Wordware API 응답을 처리합니다.
- SSE(Server-Sent Events) 스트림을 구문 분석합니다.
- 모든 출력 값을 수집합니다
- Claude에 대한 응답을 사용자 친화적인 방식으로 형식화합니다.
고급 기능
지능형 매개변수 처리
서버는 다양한 입력 매개변수 형식을 자동으로 처리합니다.
- 직접 매개변수:
{"Full Name": "John Doe", "Company": "Acme Inc."} - kwargs의 JSON 문자열:
{"kwargs": "{\"Full Name\": \"John Doe\", \"Company\": \"Acme Inc.\"}"} - 중첩된 매개변수:
{"kwargs": {"Full Name": "John Doe", "Company": "Acme Inc."}}
입력 스키마 감지
서버는 각 도구의 입력 스키마를 분석하여 올바른 형식을 결정합니다.
- 도구에
kwargs객체로 래핑된 매개변수가 필요한지 감지합니다. - 더 나은 문서화를 위해 내부 속성을 추출합니다.
- 각 도구에 대한 매개변수 형식을 자동으로 조정합니다.
오류 처리 및 복구
강력한 오류 처리에는 다음이 포함됩니다.
- 이벤트 루프 모니터링 및 복구
- 모든 요청 및 응답에 대한 자세한 로깅
- HTTP 오류 및 시간 초과의 우아한 처리
- 문제 해결을 위한 포괄적인 오류 메시지
문제 해결
- Claude Desktop에 도구가 표시되지 않음 : 서버가 실행 중이고 Claude Desktop 설정에 제대로 등록되어 있는지 확인하세요.
- 인증 오류 : Wordware API 키가
.env파일에 올바르게 설정되었는지 확인하세요. - 매개변수 검증 오류 : 입력 형식이 도구 요구 사항과 일치하는지 확인하세요.
- 이벤트 루프 오류 : "이벤트 루프가 닫혔습니다" 오류가 표시되면 서버를 다시 시작해 보세요.
개발
서버를 확장하거나 수정하려면:
기여하다
기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
감사의 말
- 모델 컨텍스트 프로토콜을 위한 Anthropic
- 에이전트 플랫폼을 위한 Wordware
- 프로토콜 구현을 위한 MCP Python SDK
This server cannot be installed
Claude와 같은 AI 어시스턴트와 Wordware의 전문 에이전트 기능을 연결하는 모델 컨텍스트 프로토콜 서버로, 표준화된 인터페이스를 통해 모든 Wordware 흐름에 대한 동적 로딩 및 액세스를 허용합니다.