Tiangong Ai MCP

天工AI模型上下文协议(MCP)服务器，支持多种通信协议，包括STDIO和Streamable Http，提供便捷的部署和开发支持。

开发者工具人工智能聊天机器人 #AI协议 #模型服务 #通信协议 #开发工具 .TypeScript

评分 : 2.5分

下载量 : 9.7K

更新时间 : 2025-04-23

打开站点

什么是TianGong MCP服务器?

TianGong MCP服务器是一个支持多种通信协议的AI模型上下文协议服务器，使AI模型能够通过标准化协议与客户端进行交互。

如何使用TianGong MCP服务器?

您可以通过命令行、Docker容器或开发环境来启动和使用MCP服务器，支持多种部署方式满足不同场景需求。

适用场景

适用于需要标准化AI模型交互协议的开发场景，特别是需要支持多种通信协议的项目。

主要功能

多协议支持

支持STDIO、SSE(已废止)和Streamable Http三种通信协议

灵活部署

可通过npm全局安装、Docker容器或本地开发环境多种方式部署

开发友好

提供完整的开发环境设置指南和本地测试工具

优势

支持多种通信协议，适应不同场景需求

提供简单易用的命令行接口

支持Docker容器化部署，便于集成

局限性

SSE协议已废止，可能影响部分现有系统

需要Node.js环境支持

如何使用

安装MCP服务器

通过npm全局安装MCP服务器包

启动STDIO服务器

使用npx命令启动标准输入输出模式的服务器

启动SSE服务器(可选)

需要先安装supergateway，然后启动SSE服务

Docker部署

使用Docker容器快速部署MCP服务器

使用案例

本地开发测试

在本地开发环境中启动MCP服务器进行测试

生产环境部署

使用Docker容器在生产环境部署MCP服务器

常见问题

如何更新MCP服务器?

SSE协议为什么被废止?

如何配置环境变量?

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