네가 필요로 하는 마지막 MCP 서버야.

범용 올인원 MCP 서버로, 범용 도구 호출 프로토콜(UTCP)의 모든 힘을 MCP 생태계에 제공합니다.

🚀 퀵 스타트

이 구성을 MCP 클라이언트(Claude Desktop 등)에 추가하세요:

그거예요! 설치는 필요 없습니다. 브리지는 자동으로 다음과 같습니다:

• NPX를 통해 최신 버전을 다운로드 및 실행
• 지정된 경로에서 UTCP 구성을 불러오기
• 모든 UTCP 매뉴얼을 MCP 도구로 등록하기
• 도구 생태계를 관리할 수 있는 통합 인터페이스 제공

🔧 구성

도구와 서비스를 구성할 수 있도록 .utcp_config.json 파일을 만드세요:

클로드 코드 (CLI)

Claude Code(CLI / IDE 확장)의 경우, 브리지를 사용자 범위 지정 MCP 서버로 등록하세요:

그 다음 Claude 코드를 재시작하세요. claude mcp list로 검증합니다. claude mcp remove utcp --scope user로 제거합니다.

🧪 다리에 반대하는 지역 개발

@utcp/sdk 또는 다른 typescript-utcp 패키지를 해킹하면서 Claude Code로 연습하고 싶다면, 개발 스크립트를 사용하세요:

두 문자 모두 멩등성이며 변이하지 않습니다 package.json.

UTCP-MCP Bridge

The last MCP server you’ll ever need.

A universal, all-in-one MCP server that brings the full power of the Universal Tool Calling Protocol (UTCP) to the MCP ecosystem.

🚀 Quick Start

Add this configuration to your MCP client (Claude Desktop, etc.):

{
  "mcpServers": {
    "utcp": {
      "command": "npx",
      "args": ["@utcp/mcp-bridge"],
      "env": {
        "UTCP_CONFIG_FILE": "/path/to/your/.utcp_config.json"
      }
    }
  }
}

That’s it! No installation required. The bridge will automatically:

• Download and run the latest version via npx
• Load your UTCP configuration from the specified path
• Register all your UTCP manuals as MCP tools
• Provide a unified interface to manage your tool ecosystem

🔧 Configuration

Create a .utcp_config.json file to configure your tools and services:

{
    "load_variables_from": [
      {
        "variable_loader_type": "dotenv",
        "env_file_path": ".env"
      }
    ],
    "manual_call_templates": [
      {
          "name": "openlibrary",
          "call_template_type": "http",
          "http_method": "GET", 
          "url": "https://openlibrary.org/static/openapi.json",
          "content_type": "application/json"
      }
    ],
    "post_processing": [
      {
          "tool_post_processor_type": "filter_dict",
          "only_include_keys": ["name", "description"],
          "only_include_tools": ["openlibrary.*"]
      }
    ],
    "tool_repository": {
      "tool_repository_type": "in_memory"
    },
    "tool_search_strategy": {
      "tool_search_strategy_type": "tag_and_description_word_match"
    }
}

Claude Code (CLI)

For Claude Code (the CLI / IDE extension), register the bridge as a user-scoped MCP server:

claude mcp add-json --scope user utcp '{"type":"stdio","command":"npx","args":["@utcp/mcp-bridge"],"env":{"UTCP_CONFIG_FILE":"/absolute/path/to/.utcp_config.json"}}'

Then restart Claude Code. Verify with claude mcp list. Remove with claude mcp remove utcp --scope user.

🧪 Local development against the bridge

If you’re hacking on @utcp/sdk or any other typescript-utcp package and want to exercise it through Claude Code, use the dev scripts:

cd utcp-mcp
npm install
npm run dev:register     # builds typescript-utcp packages, overlays each into the bridge's node_modules, builds the bridge, and registers it as 'utcp-dev' in Claude Code
# restart Claude Code

# After every edit:
npm run dev:register     # rebuilds, re-registers; restart Claude Code

# When done:
npm run dev:unregister   # removes the MCP entry and restores registry node_modules

Both scripts are idempotent and never mutate package.json. The overlay strategy avoids npm link, which under modern npm aliases unlink to uninstall --save and would silently strip the dependency.