工作场所搜索API服务

一个基于FastAPI的工作场所搜索API服务,提供搜索、内容获取、最近记录和摘要功能,通过Descope和Google Drive进行OAuth验证。

  • by Aman-Shukla
  • Dockerfile
  • 本地部署
  • 更新于
在 GitHub 查看 aman-shukla/workplace-mcp-server

使用说明

工作场所搜索mcp

One-liner:FastAPI服务公开了一个小型工作场所搜索API(搜索、内容、最近、摘要),该服务旨在由Cequence AI网关(MCP)通过Descope和Google Drive出站包装OAuth。

包括什么

  • 实现MCP使用的端点的最小FastAPI应用程序
  • 描述JWT验证+范围执行
  • 谷歌云端硬盘提供商(使用谷歌api python客户端)
  • 描述用于获取每个用户Google令牌的出站连接器存根
  • 简易总结器(可选)
  • Dockerfile+要求

快速入门(本地)

  1. 创建并激活virtualenv:
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
  1. 必需的环境变量(导出或放入 .env):
DESCOPE_ISSUER=https://api.descope.com/<your-tenant-id>/v1
DESCOPE_JWKS=https://api.descope.com/<your-tenant-id>/v1/.well-known/jwks.json
DESCOPE_API_KEY=<your-server-api-key-for-descope>
DESCOPE_TENANT_ID=<your-descope-tenant-id>
GOOGLE_PROJECT_ID=<your-google-project-id>
  1. 在本地运行
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
  1. 访问 http://localhost:8000/docs 查看OpenAPI和测试端点。

部署

  • 构建Docker镜像,并根据需要部署到Fly/Render/Vercel。
  • 请确保在部署环境中设置env变量。

后果/MCP

  • 上传 http://<your-host>/openapi.json 在创建MCP服务器时停止。
  • 地图范围 docs.read, docs.content, docs.summarize 到端点。