mcpField
L
local-server

local-server

github.com/aiagentwithdhruv云与 DevOps2041 次安装15 周前更新
代码仓库

关于 local-server

local-server 用于在本地运行 Claude orchestrator,并可通过 Cloudflare tunnel 接收外部 webhook。它面向开发和调试场景,使用本地文件、凭据与 .env 配置。

主要功能

  1. 01在本地启动 FastAPI 服务
  2. 02提供 directive、webhook 列表和 Agent 任务端点
  3. 03可用 Cloudflare tunnel 暴露外部访问
  4. 04直接使用本地文件、凭据和 .env
  5. 05支持端口配置,默认端口为 8000

适用场景

  1. 01本地迭代 Claude orchestrator
  2. 02调试 webhook 相关流程
  3. 03在本地环境执行 directive 或通用 Agent 任务

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/aiagentwithdhruv/skills --skill local-server

安装后在 Claude Code 中输入/local-server确认已加载。

详细介绍

本地服务器执行

目标

使用 Cloudflare 隧道在本地运行 Claude 编排器,以便通过外部 Webhook 访问。

启动服务器

python3 execution/local_server.py

在 8000 端口上启动 FastAPI 服务器。

Cloudflare 隧道

如需外部访问(Webhook),请使用 Cloudflare 隧道:

cloudflared tunnel --url http://localhost:8000

端点

与 Modal 部署相同:

  • /directive?slug={slug} - 执行指令
  • /list-webhooks - 列出 Webhook
  • /general-agent - 通用 Agent 任务

开发用途

  • 比 Modal 部署更快地迭代
  • 完全访问本地文件和凭据
  • 使用 print 语句实时调试

环境

直接使用本地 .env 文件(Modal 使用 secrets,与此不同)。


架构

输入
名称类型必填描述
portinteger否服务器端口(默认:8000)
输出
名称类型描述
server_urlstring本地服务器 URL(http://localhost:8000)
tunnel_urlstringCloudflare 隧道 URL(如果已启用)
可组合使用

与此工具配合良好的技能:add-webhook

费用

免费(本地执行)

评论

支持 Markdown