🚀 天宫 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