上下文协议网关服务

一个基于Docker部署的上下文协议网关服务,提供REST API接口管理gateways、virtual servers和tools,支持SSE和MCP协议连接。

  • by PinXian53
  • 本地部署
  • 更新于
在 GitHub 查看 PinXian53/mcp-context-forge

使用说明

mcp-context-forge

  • Github: https://github.com/ibm/mcp-context-forge
  • Docs: https://ibm.github.io/mcp-context-forge/
  • Code Wiki: https://codewiki.google/github.com/ibm/mcp-context-forge
  • Deep Wiki: https://deepwiki.com/IBM/mcp-context-forge

使用 Docker 啟動

docker run -d --name mcpgateway \
  -p 4444:4444 \
  -e MCPGATEWAY_UI_ENABLED=true \
  -e MCPGATEWAY_ADMIN_API_ENABLED=true \
  -e HOST=0.0.0.0 \
  -e JWT_SECRET_KEY=my-test-key \
  -e BASIC_AUTH_USER=admin \
  -e BASIC_AUTH_PASSWORD=changeme \
  -e AUTH_REQUIRED=true \
  -e PLATFORM_ADMIN_EMAIL=admin@example.com \
  -e PLATFORM_ADMIN_PASSWORD=changeme \
  -e PLATFORM_ADMIN_FULL_NAME="Platform Administrator" \
  -e DATABASE_URL=sqlite:///./mcp.db \
  ghcr.io/ibm/mcp-context-forge:0.9.0

API Endpoints

https://github.com/ibm/mcp-context-forge?tab=readme-ov-file#api-endpoints

取得 gateways 清單

curl --location 'http://localhost:4444/gateways' \
  --header 'Authorization: Bearer ${MCPGATEWAY_BEARER_TOKEN}'

取得 virtual servers 清單

curl --location 'http://localhost:4444/servers' \
  --header 'Authorization: Bearer ${MCPGATEWAY_BEARER_TOKEN}'

取得 tools 清單

curl --location 'http://localhost:4444/tools' \
  --header 'Authorization: Bearer ${MCPGATEWAY_BEARER_TOKEN}'

連線 mcp (透過 gateway、virtual servers)

# Transport Type: SSE, URL: http://localhost:4444/servers/UUID_OF_SERVER_1/sse,  Header Name: "Authorization", Bearer Token
http://localhost:4444/servers/${UUID_OF_SERVER}/sse
http://localhost:4444/servers/${UUID_OF_SERVER}/mcp

REST API to MCP

https://ibm.github.io/mcp-context-forge/manage/bulk-import/

  1. 在 Tools 頁面,使用 Add New Tool from REST API 建立新的 Tool
  2. 在 Virtual Servers 頁面,選擇剛剛建立的 Tool,再建立 MCP Server

Test

npx @modelcontextprotocol/inspector