Heroku MCP文档阅读器(HTML/PDF-->Markdown)
- Heroku MCP文档阅读器(HTML/PDF-->Markdown)
- 自动部署
- 手动部署
- 从Heroku CLI设置所需的环境变量
- 局部测试
- 本地流式HTTP、SSE
- 本地流式HTTP、SSE-请求示例
- 本地STDIO
- 1.本地STDIO-Python STDIO客户端示例
- 2.本地STDIO-直拨电话
- 远程测试
- 远程SSE
- 远程STDIO
- 1.远程STDIO-在服务器上运行的Python STDIO客户端示例
- 2.远程STDIO-直接呼叫一次性Dyno
- 3.即将推出-Heroku MCP网关!
自动部署
手动部署
从Heroku CLI设置所需的环境变量
使用Heroku CLI提取正确的值,而不是手动设置每个变量。```bash
export APP_NAME=
heroku create $APP_NAME
heroku buildpacks:set heroku/python -a $APP_NAME
set a private API key that you create, for example:
heroku config:set API_KEY=$(openssl rand -hex 32) -a $APP_NAME
heroku config:set STDIO_MODE_ONLY= -a $APP_NAME
set the remote server type (module) that your web process will use (only relevant for web deployments)
heroku config:set REMOTE_SERVER_TRANSPORT_MODULE=
如果你 *仅* 希望本地部署 `STDIO` 能力(否 `SSE server`),运行:```bash
heroku ps:scale web=0 -a $APP_NAME
如果您确实希望部署 SSE 服务器,运行:```bash
heroku ps:scale web=1 -a $APP_NAME
heroku config:set WEB_CONCURRENCY=1 -a $APP_NAME
(可选)将这些配置变量放入本地.env文件中进行本地开发:```bash
heroku config -a $APP_NAME --shell | tee .env > /dev/null
接下来,将您的应用程序连接到git仓库:```bash
heroku git:remote -a $APP_NAME
并部署!```bash
git push heroku main
通过以下方式查看日志:```bash
heroku logs --tail -a $APP_NAME
## 局部测试
一次性软件包安装:```bash
virtualenv venv
source venv/bin/activate
pip install -r requirements.txt
本地流式HTTP、SSE
如果您正在测试(无状态)可流式HTTP或SSE,则需要在一个终端窗格中启动服务器:```bash
source venv/bin/activate
export API_KEY=$(heroku config:get API_KEY -a $APP_NAME)
Either run src.streamable_http_server or src.sse_server, here:
uvicorn src.streamable_http_server:app --reload
*跑步 `--reload` 是可选的,但对当地发展很有帮助*
接下来,在一个新窗格中,您可以尝试对服务器运行一些查询:
#### 本地流式HTTP、SSE-请求示例
第一轮:```bash
export API_KEY=$(heroku config:get API_KEY -a $APP_NAME)
在以下命令中,使用 example_clients/streamable_http_client.py 如果您运行了上面的流式HTTP服务器,或者 example_clients/sse_client.py 如果您正在运行SSE服务器。
列出工具:```bash
python example_clients/streamable_http_client.py mcp list_tools | jq
示例工具调用请求-HTML:
*注意:如果您已设置,这将故意不起作用 `STDIO_MODE_ONLY` 到 `true`.*```bash
python example_clients/streamable_http_client.py mcp call_tool --args '{
"name": "html_to_markdown",
"arguments": {
"url": "https://example.com"
}
}' | jq
示例工具调用请求-PDF:```bash
python example_clients/streamable_http_client.py mcp call_tool --args '{
"name": "pdf_to_markdown",
"arguments": {
"url": "https://arxiv.org/pdf/1706.03762"
}
}' | jq
### 本地STDIO
有两种方法可以在STDIO模式下轻松测试MCP服务器:
#### 1.本地STDIO-Python STDIO客户端示例
列出工具:```
python example_clients/stdio_client.py mcp list_tools | jq
示例工具调用请求-HTML:
注意:如果您已设置,这将故意不起作用 STDIO_MODE_ONLY 到 true.```bash
python example_clients/stdio_client.py mcp call_tool --args '{
"name": "html_to_markdown",
"arguments": {
"url": "https://example.com"
}
}' | jq
示例工具调用请求-PDF:```bash
python example_clients/stdio_client.py mcp call_tool --args '{
"name": "pdf_to_markdown",
"arguments": {
"url": "https://arxiv.org/pdf/1706.03762"
}
}' | jq
2.本地STDIO-直拨电话
示例工具调用请求:
cat < logs.txt" <
