Generic MCP Server 014f56c8

MCP运维云端

提供方 buildsomething01

运维云端 stdio · 本地进程 会话登录 社区 / 第三方
查看接入方式

一个基于元数据的模型上下文协议(MCP)服务器实现,自动从Firestore发现工具并动态路由工具调用至相应端点。

一句话选型结论

按资料字段整理

Generic MCP Server 014f56c8 属于运维云端类 MCP 服务器,stdio · 本地进程,会话登录,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权会话登录 部署方式本地部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

元数据驱动Python本地部署动态路由工具发现会话管理云原生

安装与配置

stdio · 本地进程 会话登录
客户端在本机拉起子进程,数据不出本机
pip install -r requirements.txt

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Generic MCP Server 014f56c8当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方buildsomething01上游标注的维护方 buildsomething01
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

6.9 KB
来自项目仓库与上游目录的原文,未做删改

Generic MCP Server

A generic, metadata-driven Model Context Protocol (MCP) server implementation that automatically discovers tools from Firestore and dynamically routes tool calls to their respective endpoints.

Overview

This MCP server provides a flexible, scalable architecture for managing tools without requiring code changes. Tools are registered in Google Cloud Firestore, and the server automatically:

  • Discovers tools from the Firestore registry at startup
  • Dynamically routes tool calls to their configured endpoints
  • Supports streaming and synchronous responses
  • Manages sessions for MCP protocol compliance

Features

  • 🔄 Automatic Tool Discovery: Tools are loaded from Firestore on startup
  • 🎯 Dynamic Routing: Tool calls are routed to endpoints defined in metadata
  • 📡 Streaming Support: Supports both streaming and synchronous tool execution
  • 🔐 Session Management: Maintains MCP session state for client interactions
  • 🐳 Docker Ready: Includes Dockerfile for containerized deployment
  • ☁️ Cloud Native: Built for Google Cloud Platform with Firestore integration

Architecture```

┌─────────────┐
│ Client │
└──────┬──────┘
│ MCP Protocol (JSON-RPC)
▼
┌─────────────────────┐
│ MCP Server │
│ (FastAPI) │
└──────┬──────────────┘
│
├──► Firestore (Tool Registry)
│ └──► Tool Metadata
│
└──► Dynamic Routing
└──► External Services (run_url)


### How It Works

1. **Tool Registration**: Tools are registered in Firestore's `tool_registry` collection with their metadata
2. **Discovery**: On startup, the server loads all tools from Firestore
3. **Capability Building**: Server builds MCP capabilities based on discovered tools
4. **Dynamic Routing**: When a tool is called, the server routes the request to the `run_url` specified in the tool's metadata

## Prerequisites

- Python 3.11+
- Google Cloud Project with Firestore enabled
- Google Cloud credentials configured (via `gcloud auth application-default login` or service account)

## Installation

### Using pip```bash
pip install -r requirements.txt

Using pipenv```bash

pipenv install


## Configuration

### Firestore Setup

1. Create a Firestore database in your Google Cloud project
2. Create a collection named `tool_registry`
3. Add tool documents with the following structure:```json
{
  "name": "tool_name",
  "description": "Tool description",
  "parameters": {
    "type": "object",
    "properties": {
      "param1": {
        "type": "string",
        "description": "Parameter description"
      }
    },
    "required": ["param1"]
  },
  "output_schema": {
    "type": "object",
    "properties": {
      "result": {"type": "string"}
    }
  },
  "run_url": "https://your-service.com/endpoint",
  "metadata": {
    "service": "service-name"
  }
}

Seeding Firestore

Use the provided seed script to populate Firestore with tool definitions:```bash
python firestore/seed.py


Make sure to update the project ID in `firestore/seed.py` to match your Google Cloud project.

## Running the Server

### Local Development```bash
uvicorn main:app --reload --port 8080

Production (with Gunicorn)```bash

gunicorn main:app -k uvicorn.workers.UvicornWorker --bind 0.0.0.0:8080 --workers 2


### Docker```bash
# Build the image
docker build -t mcp-server .

# Run the container
docker run -p 8080:8080 \
  -v /path/to/gcloud/credentials.json:/app/credentials.json \
  -e GOOGLE_APPLICATION_CREDENTIALS=/app/credentials.json \
  mcp-server

API Endpoints

MCP Handler

POST /mcp

Main MCP protocol endpoint that handles JSON-RPC requests.

Supported Methods

  • initialize: Initialize a new MCP session
  • tools/list: List all available tools
  • tools/call: Execute a tool with optional streaming

Example Request```json

{
"jsonrpc": "2.0",
"id": "1",
"method": "tools/call",
"params": {
"name": "get_pet",
"arguments": {
"pet_id": "123"
},
"stream": false
}
}


#### Example Response```json
{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"id\": \"123\", \"name\": \"Fluffy\"}"
      }
    ]
  }
}

Tool Metadata Schema

Each tool in Firestore must have the following structure:

Field Type Required Description
name string Yes Unique tool identifier
description string Yes Human-readable tool description
parameters object Yes JSON Schema for input parameters
output_schema object No JSON Schema for output structure
run_url string Yes HTTP endpoint to route tool calls to
metadata object No Additional metadata (e.g., service name)

Project Structure```

petstore_mcp_server/
├── main.py # FastAPI application entry point
├── mcp/
│ ├── registry.py # Firestore tool registry loader
│ └── router.py # MCP protocol router
├── transport/
│ └── sse_transport.py # SSE transport implementation
├── firestore/
│ └── seed.py # Firestore seeding script
├── requirements.txt # Python dependencies
├── Dockerfile # Docker configuration
└── README.md # This file


## Development

### Adding a New Tool

1. Add tool metadata to Firestore's `tool_registry` collection
2. Ensure the `run_url` points to a valid endpoint
3. Restart the server to load the new tool

No code changes required! The server will automatically discover and expose the new tool.

### Testing```bash
# Test tool listing
curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "tools/list"
  }'

# Test tool execution
curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: <session-id>" \
  -d '{
    "jsonrpc": "2.0",
    "id": "2",
    "method": "tools/call",
    "params": {
      "name": "get_pet",
      "arguments": {"pet_id": "123"}
    }
  }'

MCP Protocol Compliance

This server implements the Model Context Protocol specification:

  • Protocol Version: 2025-03-26
  • Transport: HTTP POST with JSON-RPC 2.0
  • Session Management: Via Mcp-Session-Id header
  • Streaming: Supported via Server-Sent Events (SSE)

Dependencies

  • fastapi: Web framework
  • uvicorn: ASGI server
  • gunicorn: Production WSGI server
  • httpx: HTTP client for routing tool calls
  • google-cloud-firestore: Firestore client library

License

[Add your license here]

Contributing

[Add contribution guidelines here]

Support

[Add support information here]

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Generic MCP Server 014f56c8 怎么安装?

在客户端按下面的安装命令接入:pip install -r requirements.txt。装完在客户端配置里引用同一个包或端点。

Generic MCP Server 014f56c8 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Generic MCP Server 014f56c8 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Generic MCP Server 014f56c8 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Generic MCP Server 014f56c8 能提供哪些能力?

资料显示能力标签包括 Python、工具发现、会话管理。具体工具清单以官方文档为准。

Generic MCP Server 014f56c8 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Generic MCP Server 014f56c8 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。