MCP-Bridge는 OpenAI API와 MCP(MCP) 도구 간의 다리 역할을 하여, 개발자가 OpenAI API 인터페이스를 통해 MCP 도구를 활용할 수 있도록 합니다.

[! 참고]

프로젝트를 도와줄 새로운 유지보수자를 찾고 있습니다. 관심 있으시면 디스코드에서 연락하거나 이슈를 열어보세요.

또한 Open WebUI는 v0.6.31부터 MCP(모델 컨텍스트 프로토콜)를 네이티브로 지원하므로 MCP-Bridge는 이제 소프트 폐지된 것으로 간주되어야 합니다.

개요

MCP-Bridge는 MCP 도구와 OpenAI API의 통합을 용이하게 하도록 설계되었습니다. OpenAI API와 호환되는 방식으로 MCP 도구와 상호작용할 수 있는 엔드포인트 집합을 제공합니다. 이를 통해 MCP를 명시적으로 지원하지 않고도 어떤 클라이언트든 어떤 MCP 도구든 사용할 수 있습니다. 예를 들어, 공식 MCP fetch 도구와 함께 Open Web UI를 사용하는 예시를 참고하세요.

현재 특징

작동 기능:

• MCP를 이용한 비스트리밍 채팅 완료

• MCP를 이용한 스트리밍 채팅 완료

• MCP 없이 스트리밍이 아닌 완료

• MCP 도구

• MCP 샘플링

• 외부 클라이언트용 SSE 브리지

계획된 기능:

• 스트리밍 완성 기능이 아직 구현되지 않았다

• MCP 자원 지원이 계획되어 있습니다

설치

MCP-Bridge

MCP-Bridge acts as a bridge between the OpenAI API and MCP (MCP) tools, allowing developers to leverage MCP tools through the OpenAI API interface.

[!NOTE]

Looking for new maintainers to assist with the project. Reach out in the Discord or open an issue if you are interested.

Additionally, Open WebUI natively supports MCP (Model Context Protocol) starting in v0.6.31, so MCP-Bridge should be considered as soft deprecated now.

Overview

MCP-Bridge is designed to facilitate the integration of MCP tools with the OpenAI API. It provides a set of endpoints that can be used to interact with MCP tools in a way that is compatible with the OpenAI API. This allows you to use any client with any MCP tool without explicit support for MCP. For example, see this example of using Open Web UI with the official MCP fetch tool.

Current Features

working features:

• non streaming chat completions with MCP

• streaming chat completions with MCP

• non streaming completions without MCP

• MCP tools

• MCP sampling

• SSE Bridge for external clients

planned features:

• streaming completions are not implemented yet

• MCP resources are planned to be supported

Installation

The recommended way to install MCP-Bridge is to use Docker. See the example compose.yml file for an example of how to set up docker.

Note that this requires an inference engine with tool call support. I have tested this with vLLM with success, though ollama should also be compatible.

Docker installation

1. Clone the repository

2. Edit the compose.yml file

You will need to add a reference to the config.json file in the compose.yml file. Pick any of

• add the config.json file to the same directory as the compose.yml file and use a volume mount (you will need to add the volume manually)
• add a http url to the environment variables to download the config.json file from a url
• add the config json directly as an environment variable

see below for an example of each option:

environment:
  - MCP_BRIDGE__CONFIG__FILE=config.json # mount the config file for this to work
  - MCP_BRIDGE__CONFIG__HTTP_URL=http://10.88.100.170:8888/config.json
  - MCP_BRIDGE__CONFIG__JSON={"inference_server":{"base_url":"http://example.com/v1","api_key":"None"},"mcp_servers":{"fetch":{"command":"uvx","args":["mcp-server-fetch"]}}}

The mount point for using the config file would look like:

    volumes:
      - ./config.json:/mcp_bridge/config.json

3. run the service

docker-compose up --build -d