Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 28 additions & 0 deletions src/fetch/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -168,6 +168,34 @@ This can be customized by adding the argument `--user-agent=YourUserAgent` to th

The server can be configured to use a proxy by using the `--proxy-url` argument.

## Deployment to MCP Agent Cloud

The repository ships with a ready-to-use deployment config for [MCP Agent Cloud](https://docs.mcp-agent.com/cloud/use-cases/deploy-mcp-servers). To publish this server:

1. Authenticate once with `mcp-agent login`.
2. From `servers/src/fetch`, deploy with `mcp-agent deploy fetch-server --app-description "Fetch MCP server"`.
3. Inspect the live endpoint using `mcp-agent cloud servers describe fetch-server`, then install it into a client (for example `mcp-agent install https://<app_id>.deployments.mcp-agent.com/sse --client cursor`).

The deployment uses `mcp_agent.config.yaml` (same directory), mirroring the [mcp-agent cloud example](https://github.com/lastmile-ai/mcp-agent/tree/main/examples/cloud/mcp). It launches the stdio fetch server via `uvx mcp-server-fetch`, and `main.py` wires the tool into the cloud runtime using `FastMCP`.

**Hosted instance**

- App URL: `https://xxucyrqrp9xazl7kat535fkhnugne7h.deployments.mcp-agent.com`
- SSE endpoint: `https://xxucyrqrp9xazl7kat535fkhnugne7h.deployments.mcp-agent.com/sse`
- Tool name: `fetch_url`

To connect with Inspector:

```bash
killall node 2>/dev/null || true
npx --yes @modelcontextprotocol/inspector \
--transport sse \
--server-url https://xxucyrqrp9xazl7kat535fkhnugne7h.deployments.mcp-agent.com/sse \
--header "Authorization: Bearer <token from deploy output>"
```

If `readabilipy` or `markdownify` are unavailable in the environment, the server gracefully falls back to returning raw HTML. To pass optional CLI flags (such as `--ignore-robots-txt`, `--user-agent`, or `--proxy-url`), edit `mcp_agent.config.yaml` before re-running `mcp-agent cloud deploy`.

## Windows Configuration

If you're experiencing timeout issues on Windows, you may need to set the `PYTHONIOENCODING` environment variable to ensure proper character encoding:
Expand Down
10 changes: 10 additions & 0 deletions src/fetch/inspector.mcp.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
{
"mcpServers": {
"fetch": {
"command": "uvx",
"args": ["mcp-server-fetch"],
"transport": "stdio",
"description": "Fetch MCP server for local Inspector testing"
}
}
}
Loading
Loading