AI导哈

个人MCP服务器

一个简单快速的个人MCP服务器，用于构建针对就业和项目历史的目标配置文件。

  • by Nadrons
  • HTML
  • 混合部署
  • 更新于
在 GitHub 查看 Nadrons/personalMCP

使用说明

个人MCP服务器

个人MCP服务器的一个简单fastMCP示例。使用一组文档文件（不包含在仓库中）允许代理构建有针对性的就业和项目历史档案。

公共URI

可以在以下网址访问实时MCP服务器 hjhero.com/mcp 配置说明可在 hjhero.com

部署服务器

此MCP服务器可以作为以下方式运行：

  • streamable-http （默认）用于托管/网络部署
  • stdio 适用于本地桌面MCP客户端

本地运行（HTTP）

python personal_mcp.py

默认情况下，这将开始：

  • 运输： streamable-http
  • 主持人： 0.0.0.0
  • 端口： PORT （如果设置），否则 MCP_PORT （默认值 8000)
  • MCP路径： /mcp

通过环境变量进行配置

  • MCP_TRANSPORT = streamable-http | sse | stdio
  • MCP_HOST （默认值 0.0.0.0)
  • PORT （云平台运行时端口；如果已设置，则首选）
  • MCP_PORT （默认值 8000；在以下情况下使用 PORT 未设置）
  • MCP_STREAMABLE_HTTP_PATH （默认值 /mcp)
  • MCP_MOUNT_PATH （可选；SSE装载路径）
  • MCP_API_KEY （可选；如果设置，HTTP请求需要 Authorization: Bearer <key> 或 x-api-key: <key>)
  • MCP_HEALTH_PATH （默认值 /healthz)
  • MCP_LOG_LEVEL （默认值 info)

例子：

MCP_HOST=0.0.0.0 MCP_PORT=8080 MCP_TRANSPORT=streamable-http python personal_mcp.py

在本地运行（stdio）

python personal_mcp.py --transport stdio

在Docker中运行（HTTP）

构建图像：

docker build -t personal-mcp:latest .

运行容器：

docker run --rm -p 8000:8000 \
	-e MCP_TRANSPORT=streamable-http \
	-e MCP_HOST=0.0.0.0 \
	-e MCP_PORT=8000 \
	personal-mcp:latest

托管托管选项

docker容器可以部署到Render、Railway、Fly.io、Azure容器应用程序或ECS/Fargate等平台。它目前托管在Macbook Air上。

推荐的生产设置：

  • 保持 MCP_TRANSPORT=streamable-http
  • 绑定 MCP_HOST=0.0.0.0
  • 使用 PORT 从平台运行时（或 MCP_PORT 回退）
  • 集 MCP_API_KEY 因此，公共HTTP请求需要身份验证
  • 保持健康检查 GET /healthz （或用覆盖 MCP_HEALTH_PATH)
  • 在公开服务之前，将TLS和auth放在服务前面

安全说明

  • 如果 MCP_API_KEY 设置后，未经身份验证的HTTP请求将被拒绝 401.
  • 默认情况下，平台健康探测的健康端点保持打开状态。
  • 对于互联网曝光，仍然倾向于将其置于受管理的API网关/反向代理之后，以进行速率限制和审计日志记录。

相关 MCP