|
1 | 1 | # MCPM (Model Context Protocol Manager) - AI Agent Guide |
2 | 2 |
|
3 | | -Generated: 2025-09-13 01:49:06 UTC |
4 | | -Version: 2.8.0 |
| 3 | +Generated: 2025-09-17 14:13:26 UTC |
| 4 | +Version: 2.8.1 |
5 | 5 |
|
6 | 6 | ## Overview |
7 | 7 |
|
@@ -688,32 +688,48 @@ mcpm profile run web-dev --port 8080 --http |
688 | 688 |
|
689 | 689 | ## mcpm run |
690 | 690 |
|
691 | | -Execute a server from global configuration over stdio, HTTP, or SSE. |
| 691 | +Execute an installed MCP server in stdio (default), HTTP, or SSE mode. |
692 | 692 |
|
693 | | - Runs an installed MCP server from the global configuration. By default |
694 | | - runs over stdio for client communication, but can run over HTTP with --http |
695 | | - or over SSE with --sse. |
| 693 | + By default, servers run over **stdio** for direct client communication. |
696 | 694 |
|
697 | | - Examples: |
698 | | - mcpm run mcp-server-browse # Run over stdio (default) |
699 | | - mcpm run --http mcp-server-browse # Run over HTTP on 127.0.0.1:6276 |
700 | | - mcpm run --sse mcp-server-browse # Run over SSE on 127.0.0.1:6276 |
701 | | - mcpm run --http --port 9000 filesystem # Run over HTTP on 127.0.0.1:9000 |
702 | | - mcpm run --sse --port 9000 filesystem # Run over SSE on 127.0.0.1:9000 |
703 | | - mcpm run --http --host 0.0.0.0 filesystem # Run over HTTP on 0.0.0.0:6276 |
704 | | - |
705 | | - Note: stdio mode is typically used in MCP client configurations: |
| 695 | + **Examples:** |
| 696 | + |
| 697 | + STDIO Mode (default): |
| 698 | + |
| 699 | + |
| 700 | + mcpm run server-name |
| 701 | + |
| 702 | + HTTP Mode: |
| 703 | + |
| 704 | + |
| 705 | + mcpm run --http server-name |
| 706 | + mcpm run --http --port 9000 server-name |
| 707 | + mcpm run --http --host 0.0.0.0 server-name |
| 708 | + |
| 709 | + SSE Mode: |
| 710 | + |
| 711 | + |
| 712 | + mcpm run --sse server-name |
| 713 | + mcpm run --sse --port 9000 server-name |
| 714 | + mcpm run --sse --host 0.0.0.0 server-name |
| 715 | + |
| 716 | + Client Config Example: |
706 | 717 | {"command": ["mcpm", "run", "mcp-server-browse"]} |
| 718 | + |
| 719 | + **Tips:** |
| 720 | + • Port defaults to **6276**, auto-finds if busy |
| 721 | + • Host defaults to **127.0.0.1** |
| 722 | + • Use `mcpm ls` to see installed servers |
707 | 723 |
|
708 | 724 |
|
709 | 725 | **Parameters:** |
710 | 726 |
|
711 | 727 | - `server_name` (REQUIRED): |
712 | 728 |
|
713 | | -- `--http`: Run server over HTTP instead of stdio (flag) |
714 | | -- `--sse`: Run server over SSE instead of stdio (flag) |
715 | | -- `--port`: Port for HTTP / SSE mode (default: 6276) (default: 6276) |
716 | | -- `--host`: Host address for HTTP / SSE mode (default: 127.0.0.1) (default: 127.0.0.1) |
| 729 | +- `--http`: Run server in HTTP mode (mutually exclusive with --sse) (flag) |
| 730 | +- `--sse`: Run server in SSE mode (mutually exclusive with --http) (flag) |
| 731 | +- `--port`: Port for HTTP/SSE mode (default: 6276, auto-finds available) (default: 6276) |
| 732 | +- `--host`: Host for HTTP/SSE mode (use 0.0.0.0 for all interfaces) (default: 127.0.0.1) |
717 | 733 | - `-h`, `--help`: Show this message and exit. (flag) |
718 | 734 |
|
719 | 735 | **Examples:** |
|
0 commit comments