Tiangong Ai MCP

🚀 天宮 AI 模型上下文協議（MCP）服務器

天宮 AI 模型上下文協議（MCP）服務器支持 STDIO、SSE（已廢棄）和 Streamable Http 三種協議，為用戶提供多樣化的數據交互方式。

🚀 快速開始

✨ 主要特性

• 支持 STDIO、SSE（已廢棄）和 Streamable Http 三種協議，滿足不同場景的使用需求。

📦 安裝指南

客戶端 STDIO 服務器

npm install -g @tiangong-ai/mcp-server

npx dotenv -e .env -- \
npx @tiangong-ai/mcp-server

遠程 SSE 服務器

npm install -g @tiangong-ai/mcp-server
npm install -g supergateway

npx dotenv -e .env -- \
npx -y supergateway \
    --stdio "npx -y -p @tiangong-ai/mcp-server tiangong-ai-mcp-stdio" \
    --port 3001 \
    --ssePath /sse --messagePath /message

使用 Docker

# 使用 Dockerfile 構建 MCP 服務器鏡像（可選）
docker build -t linancn/tiangong-ai-mcp-server:0.0.8 .

# 拉取 MCP 服務器鏡像
docker pull linancn/tiangong-ai-mcp-server:0.0.8

# 使用 Docker 啟動 MCP 服務器
docker run -d \
    --name tiangong-ai-mcp-server \
    --publish 3001:80 \
    --env-file .env \
    linancn/tiangong-ai-mcp-server:0.0.8

💻 使用示例

基礎用法

以下是啟動不同類型服務器的基礎命令示例：

客戶端 STDIO 服務器

npm install -g @tiangong-ai/mcp-server

npx dotenv -e .env -- \
npx @tiangong-ai/mcp-server

遠程 SSE 服務器

npm install -g @tiangong-ai/mcp-server
npm install -g supergateway

npx dotenv -e .env -- \
npx -y supergateway \
    --stdio "npx -y -p @tiangong-ai/mcp-server tiangong-ai-mcp-stdio" \
    --port 3001 \
    --ssePath /sse --messagePath /message

使用 Docker

# 使用 Dockerfile 構建 MCP 服務器鏡像（可選）
docker build -t linancn/tiangong-ai-mcp-server:0.0.8 .

# 拉取 MCP 服務器鏡像
docker pull linancn/tiangong-ai-mcp-server:0.0.8

# 使用 Docker 啟動 MCP 服務器
docker run -d \
    --name tiangong-ai-mcp-server \
    --publish 3001:80 \
    --env-file .env \
    linancn/tiangong-ai-mcp-server:0.0.8

🔧 技術細節

開發

環境設置

# 安裝 Node.js
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.2/install.sh | bash
nvm install 22
nvm use

# 安裝依賴
npm install

# 更新依賴
npm update && npm ci

代碼格式化

# 使用代碼檢查工具格式化代碼
npm run lint

本地測試

STDIO 服務器

# 使用 MCP Inspector 啟動 STDIO 服務器
npm run start

SSE 服務器

# 打包當前項目
npm run build && npm pack

# 如果需要可以全局安裝 supergateway（可選）
npm install -g supergateway

# 啟動 SSE 服務器，如配置了參數 --baseUrl ，應設置為有效的 IP 地址或域名
npx dotenv -e .env -- \
npx -y supergateway \
    --stdio "npx -y -p tiangong-ai-mcp-server-0.0.8.tgz tiangong-ai-mcp-stdio" \
    --port 3001 \
    --ssePath /sse \
    --messagePath /message

# 啟動 MCP Inspector
npx @modelcontextprotocol/inspector

發佈

npm login

npm run build && npm publish