젠틱 MCP 플러그인
왜 Jentic MCP를 사용해야 하나요?
Jentic MCP는 개발자가 API별 코드를 작성하거나 유지 관리할 필요 없이 외부 API와 워크플로를 신속하게 탐색하고 통합할 수 있도록 지원합니다. MCP 프로토콜과 Jentic의 에이전트 런타임을 활용하여 개발자는 다음과 같은 작업을 수행할 수 있습니다.
- 공급업체나 구현이 아닌 기능별로 API와 워크플로를 검색하세요.
- 특정 API 세부 정보에 구애받지 않는 통합 코드 샘플을 즉시 생성합니다.
- 표준화되고 선언적인 통합을 사용하여 보일러플레이트를 피하고 유지 관리를 줄이세요.
- Jentic MCP가 API 상호작용의 복잡성을 처리하는 동안, 기능 구축에 집중하세요.
API 도구
Jentic MCP 플러그인은 다음과 같은 도구를 제공합니다.
search_apis : Jentic 디렉토리에서 특정 기능 요구 사항과 일치하는 API를 검색합니다.load_execution_info : Jentic 디렉터리에서 API 및 작업에 대한 자세한 사양을 가져옵니다. 여기에는 mcpServers.jentic.env 구성에 제공해야 할 인증 정보가 포함됩니다.execute : 특정 API 또는 워크플로 작업을 실행합니다.
시작하기
권장하는 방법은 uvx 사용하여 GitHub 저장소에서 직접 서버를 실행하는 것입니다. 먼저 다음을 사용하여 uv 설치해야 합니다.
brew install uv 또는 pip install uv
Jentic UUID 받기
Jentic SDK를 사용하려면 먼저 Jentic UUID를 받아야 합니다. 가장 쉬운 방법은 Jentic CLI를 사용하는 것입니다. 더 높은 요금 한도 및 새로운 기능 사전 체험을 위해 이메일 주소를 추가 할 수도 있습니다.
지엑스피1
이렇게 하면 UUID가 출력되고 환경에 맞게 설정할 수 있는 내보내기 명령이 실행됩니다.
export JENTIC_UUID=<your-jentic-uuid>
아래와 같이 MCP 클라이언트 구성에서 Jentic UUID를 설정합니다.
구성 파일의 위치는 사용 중인 클라이언트와 OS에 따라 다릅니다. 몇 가지 일반적인 예는 다음과 같습니다.
- 윈드서핑 :
~/.codeium/windsurf/mcp_config.json - Claude Desktop :
~/Library/Application Support/Claude/claude_desktop_config.json - 클로드 코드 :
~/.claude.json - 커서 :
~/cursor/.mcp.json
다른 클라이언트의 경우 MCP 서버를 추가하는 방법은 클라이언트 설명서를 확인하세요.
{
"mcpServers": {
"jentic": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp",
"mcp"
],
"env": {
"JENTIC_UUID": "<your-jentic-uuid>"
}
}
}
}
참고: 구성 파일을 저장한 후 변경 사항을 적용하려면 클라이언트 애플리케이션(Windsurf, Claude Desktop)을 다시 시작해야 할 수도 있습니다.
MCP 도구 사용
MCP 서버가 실행되면 LLM 에이전트의 MCP 도구를 사용하여 API와 워크플로를 쉽게 검색하고 실행할 수 있습니다.
search_apis : Jentic 디렉토리에서 특정 기능 요구 사항과 일치하는 API를 검색합니다.load_execution_info : Jentic 디렉터리에서 API 및 작업에 대한 자세한 사양을 가져옵니다. 여기에는 mcpServers.jentic.env 구성에 제공해야 할 인증 정보가 포함됩니다.execute : 특정 API 또는 워크플로 작업을 실행합니다.
환경 변수
인증이 필요한 API를 사용할 때 load_execution_info 도구는 필요한 환경 변수를 설명합니다. Windsurf에서는 명령줄을 통해 환경 변수를 설정할 수 있지만, Claude Desktop과 같은 일부 클라이언트에서는 MCP 설정에 환경 변수를 추가해야 합니다.
{
"mcpServers": {
"jentic": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp",
"mcp"
],
"env": {
"DISCORD_BOTTOKEN=": "YOUR BOT TOKEN"
}
}
}
}
대안(개발을 위한 로컬 경로 사용):
로컬에서 MCP 플러그인을 적극적으로 개발하는 경우 이 옵션을 사용하세요. /path/to/your/project/mcp 프로젝트 디렉터리의 절대 경로로 바꾸세요.
{
"mcpServers": {
"jentic": {
"command": "uvx",
"args": [
"--from",
"/path/to/your/project/mcp",
"mcp"
]
}
}
}
선택 사항: mcp_config.json 파일에 JENTIC_API_URL 환경 변수를 추가하여 특정 Jentic API를 가리키도록 합니다(두 가지 방법 모두 적용 가능):
{
"mcpServers": {
"jentic": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp",
"mcp"
],
"env": {
"JENTIC_API_URL": "https://your-jentic-api.url/"
}
}
}
}
구성이 완료되면 Windsurf를 다시 시작하면 Jentic MCP 도구를 사용할 수 있습니다.
다음을 실행하여 로컬로 실행 중인 MCP 서버에서 생성된 로그를 추적할 수 있습니다.
tail /path/to/mcp/jentic_ark2_mcp.log
설치
pdm 설치되어 있는지 확인하세요( pipx install pdm ).
개발을 위해 패키지와 종속성을 설치하려면:
# From the project root directory (e.g., /Users/kc/c/sdk/mcp)
pdm install -G dev
MCP 서버 실행
Jentic MCP 플러그인은 환경 설정 및 실행을 처리하는 uvx 사용하여 실행되도록 설계되었습니다.
기본 모드(Stdio)
--from 과 mcp 스크립트를 사용하여 프로젝트 디렉토리를 소스로 지정하고 uvx 사용하여 MCP 플러그인을 직접 실행합니다.
로컬 경로(개발)에서:
# Use --from with the project directory and specify the 'mcp' script
uvx --from /path/to/your/project/mcp mcp
# Or, if running from within the project directory:
uvx --from . mcp
원격 저장소에서(일반적인 용도로 권장):
uvx --from \
git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
mcp
이렇게 하면 mcp 스크립트 콜백에 정의된 기본 serve --transport stdio 명령이 자동으로 사용됩니다.
HTTP 모드
HTTP 모드에서 서버를 실행하려면(예: claude-cli 로 테스트하는 경우):
로컬 경로(개발)에서:
# Default HTTP (port 8010)
uvx --from /path/to/your/project/mcp mcp serve --transport http
# With custom port
uvx --from /path/to/your/project/mcp mcp serve --transport http --port 8080
# With custom host
uvx --from /path/to/your/project/mcp mcp serve --transport http --host 0.0.0.0 --port 8080
원격 저장소에서(권장):
uvx --from \
git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
mcp serve --transport http --port 8080
원격 Git 저장소에서 실행
uvx --from 사용하여 로컬로 복제하지 않고도 Git 저장소 URL에서 직접 MCP 서버를 실행할 수도 있습니다.
# Example from a specific branch and subdirectory
uvx --from \
git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp
# Explanation:
# - git+https://... .git : The repository URL
# - @main : The branch, tag, or commit hash
# - #subdirectory=mcp : The folder within the repo containing the pyproject.toml
이 명령은 지정된 버전을 가져오고, 임시 환경에 종속성을 설치하고, 기본 명령( serve --transport stdio )을 실행합니다.
URL 조각 뒤에 --log-level DEBUG 또는 --mock 과 같은 다른 인수를 추가할 수 있습니다.
uvx --from \
git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
--log-level DEBUG --mock
원격 소스에서 HTTP 모드로 실행하려면:
uvx --from \
git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
serve --transport http --port 8080
기타 옵션
벌채 반출
# Set logging level (applies to default stdio or explicit serve)
uvx --from /path/to/your/project/mcp mcp --log-level DEBUG
uvx --from /path/to/your/project/mcp mcp serve --transport http --log-level DEBUG
# Log to file (applies to default stdio or explicit serve)
uvx --from /path/to/your/project/mcp mcp --log-file jentic_mcp.log
uvx --from /path/to/your/project/mcp mcp serve --transport http --log-file jentic_mcp.log
모의 모드
실제 Jentic API 지식 허브에 연결하지 않고도 개발을 위한 모의 모드를 활성화합니다.
# Mock mode with default stdio
uvx --from /path/to/your/project/mcp mcp --mock
# Mock mode with explicit HTTP
uvx --from /path/to/your/project/mcp mcp serve --transport http --mock
환경 변수
.env 파일을 사용하여 환경 변수를 제공합니다.
# Env file with default stdio
uvx --from /path/to/your/project/mcp mcp --env-file .env
# Env file with explicit HTTP
uvx --from /path/to/your/project/mcp mcp serve --transport http --env-file .env
Claude와 함께 사용
MCP 플러그인은 Claude 또는 MCP 사양을 지원하는 다른 LLM과 함께 사용할 수 있습니다.
원격 저장소에서 실행(권장):
# Run the server in HTTP mode first
uvx --from \
git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
mcp serve --transport http --port 8000
# Then connect claude-cli
claude-cli --mcp http://localhost:8000
지역 경로에서 실행(개발):
# Run the server in HTTP mode first
uvx --from /path/to/your/project/mcp mcp serve --transport http --port 8000
# Then connect claude-cli
claude-cli --mcp http://localhost:8000
개발
자세한 개발 지침은 CLAUDE.md를 참조하세요.
패키지 구조
src/mcp/ : 메인 MCP 패키지transport/ : 전송 구현(HTTP, stdio)mock/ : 개발을 위한 모의 데이터 제공자tools.py : 도구 정의handlers.py : 요청 핸들러main.py : CLI 진입점adapters/ : 어댑터 구현core/ : 핵심 기능
tests/ : 테스트 모음
테스트
# Ensure dev dependencies are installed: pdm install -G dev
pdm run test
린팅 및 포맷팅
pdm 스크립트를 통해 ruff , black , isort , mypy 사용합니다.
# Run all linters/formatters
pdm run lint
# Run only ruff
pdm run linter
특허
독점 - 젠틱