pylops-mcp 0.1.1.dev0__tar.gz → 0.2.1.dev0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: pylops-mcp
3
- Version: 0.1.1.dev0
3
+ Version: 0.2.1.dev0
4
4
  Summary: PyLops MCP Server
5
5
  Project-URL: Homepage, https://github.com/PyLops/pylops-mcp
6
6
  Project-URL: Repository, https://github.com/PyLops/pylops-mcp
@@ -20,7 +20,7 @@ Classifier: Programming Language :: Python :: 3.12
20
20
  Classifier: Programming Language :: Python :: 3.13
21
21
  Classifier: Topic :: Scientific/Engineering :: Mathematics
22
22
  Requires-Python: >=3.10
23
- Requires-Dist: mcp[cli]<2
23
+ Requires-Dist: mcp[cli]<3,>=2
24
24
  Requires-Dist: numpydoc>=1.11.0
25
25
  Requires-Dist: pylops>=2.8.0
26
26
  Description-Content-Type: text/markdown
@@ -40,11 +40,13 @@ The catalog is built by introspecting the installed PyLops
40
40
 
41
41
  | Tool | Arguments | Description |
42
42
  | --- | --- | --- |
43
- | `search` | `query` (str), `kind` (`"all"` \| `"operator"` \| `"solver"`, default `"all"`) | Case-insensitive substring search over names and docstring summaries. Returns up to 20 hits (`name`, `kind`, `module`, `summary`), name matches first. |
43
+ | `search` | `query` (str), `kind` (`"all"` \| `"operator"` \| `"solver"` \| `"workflow"`, default `"all"`) | Case-insensitive substring search over names and docstring summaries. Returns up to 20 hits (`name`, `kind`, `module`, `summary`), name matches first. |
44
44
  | `list_operators` | `module` (str, optional, e.g. `"basicoperators"`) | Sorted list of operator names, optionally filtered by module. |
45
45
  | `list_solvers` | `module` (str, optional, e.g. `"sparsity"`) | Sorted list of solver names, optionally filtered by module. |
46
+ | `list_workflows` | `module` (str, optional) | Sorted list of workflow names (inversion/decomposition helpers such as `MDD`, `PrestackInversion`), optionally filtered by module. |
46
47
  | `get_operator` | `name` (str) | Signature, parameters, notes and examples of an operator. Lookup is case-insensitive. |
47
48
  | `get_solver` | `name` (str) | Signature, parameters, notes and examples of a solver. Lookup is case-insensitive. |
49
+ | `get_workflow` | `name` (str) | Signature, parameters, notes and examples of a workflow. Lookup is case-insensitive. |
48
50
 
49
51
  All responses include `pylops_version`. An unknown name returns an `error`
50
52
  together with up to 5 close-match `suggestions`.
@@ -76,8 +78,55 @@ claude mcp add --scope user pylops -- uvx pylops-mcp
76
78
  }
77
79
  ```
78
80
 
81
+ **Codex:**
82
+
83
+ ```
84
+ codex mcp add pylops -- uvx pylops-mcp
85
+ ```
86
+
87
+ or add to `~/.codex/config.toml`:
88
+
89
+ ```toml
90
+ [mcp_servers.pylops]
91
+ command = "uvx"
92
+ args = ["pylops-mcp"]
93
+ ```
94
+
95
+ **OpenCode:** add to `opencode.json` (project) or
96
+ `~/.config/opencode/opencode.json` (global):
97
+
98
+ ```json
99
+ {
100
+ "$schema": "https://opencode.ai/config.json",
101
+ "mcp": {
102
+ "pylops": { "type": "local", "command": ["uvx", "pylops-mcp"], "enabled": true }
103
+ }
104
+ }
105
+ ```
106
+
107
+ **PI:** PI has no built-in MCP support, so first install the
108
+ [`pi-mcp-adapter`](https://pi.dev/packages/pi-mcp-adapter) extension:
109
+
110
+ ```
111
+ pi install npm:pi-mcp-adapter
112
+ ```
113
+
114
+ then add to `~/.pi/agent/mcp.json` (global) or `.pi/mcp.json` (project):
115
+
116
+ ```json
117
+ {
118
+ "mcpServers": {
119
+ "pylops": { "command": "uvx", "args": ["pylops-mcp"] }
120
+ }
121
+ }
122
+ ```
123
+
79
124
  ### For Developers
80
125
 
126
+ This project is developed with Claude Code, so all the commands below are for
127
+ Claude Code only. For other clients, translate the `uv run ...` command into
128
+ that client's MCP configuration (see [For Users](#for-users)).
129
+
81
130
  Clone the repository first; the commands below assume it lives at `/path/to/pylops-mcp`.
82
131
 
83
132
  #### 1. This project only
@@ -13,11 +13,13 @@ The catalog is built by introspecting the installed PyLops
13
13
 
14
14
  | Tool | Arguments | Description |
15
15
  | --- | --- | --- |
16
- | `search` | `query` (str), `kind` (`"all"` \| `"operator"` \| `"solver"`, default `"all"`) | Case-insensitive substring search over names and docstring summaries. Returns up to 20 hits (`name`, `kind`, `module`, `summary`), name matches first. |
16
+ | `search` | `query` (str), `kind` (`"all"` \| `"operator"` \| `"solver"` \| `"workflow"`, default `"all"`) | Case-insensitive substring search over names and docstring summaries. Returns up to 20 hits (`name`, `kind`, `module`, `summary`), name matches first. |
17
17
  | `list_operators` | `module` (str, optional, e.g. `"basicoperators"`) | Sorted list of operator names, optionally filtered by module. |
18
18
  | `list_solvers` | `module` (str, optional, e.g. `"sparsity"`) | Sorted list of solver names, optionally filtered by module. |
19
+ | `list_workflows` | `module` (str, optional) | Sorted list of workflow names (inversion/decomposition helpers such as `MDD`, `PrestackInversion`), optionally filtered by module. |
19
20
  | `get_operator` | `name` (str) | Signature, parameters, notes and examples of an operator. Lookup is case-insensitive. |
20
21
  | `get_solver` | `name` (str) | Signature, parameters, notes and examples of a solver. Lookup is case-insensitive. |
22
+ | `get_workflow` | `name` (str) | Signature, parameters, notes and examples of a workflow. Lookup is case-insensitive. |
21
23
 
22
24
  All responses include `pylops_version`. An unknown name returns an `error`
23
25
  together with up to 5 close-match `suggestions`.
@@ -49,8 +51,55 @@ claude mcp add --scope user pylops -- uvx pylops-mcp
49
51
  }
50
52
  ```
51
53
 
54
+ **Codex:**
55
+
56
+ ```
57
+ codex mcp add pylops -- uvx pylops-mcp
58
+ ```
59
+
60
+ or add to `~/.codex/config.toml`:
61
+
62
+ ```toml
63
+ [mcp_servers.pylops]
64
+ command = "uvx"
65
+ args = ["pylops-mcp"]
66
+ ```
67
+
68
+ **OpenCode:** add to `opencode.json` (project) or
69
+ `~/.config/opencode/opencode.json` (global):
70
+
71
+ ```json
72
+ {
73
+ "$schema": "https://opencode.ai/config.json",
74
+ "mcp": {
75
+ "pylops": { "type": "local", "command": ["uvx", "pylops-mcp"], "enabled": true }
76
+ }
77
+ }
78
+ ```
79
+
80
+ **PI:** PI has no built-in MCP support, so first install the
81
+ [`pi-mcp-adapter`](https://pi.dev/packages/pi-mcp-adapter) extension:
82
+
83
+ ```
84
+ pi install npm:pi-mcp-adapter
85
+ ```
86
+
87
+ then add to `~/.pi/agent/mcp.json` (global) or `.pi/mcp.json` (project):
88
+
89
+ ```json
90
+ {
91
+ "mcpServers": {
92
+ "pylops": { "command": "uvx", "args": ["pylops-mcp"] }
93
+ }
94
+ }
95
+ ```
96
+
52
97
  ### For Developers
53
98
 
99
+ This project is developed with Claude Code, so all the commands below are for
100
+ Claude Code only. For other clients, translate the `uv run ...` command into
101
+ that client's MCP configuration (see [For Users](#for-users)).
102
+
54
103
  Clone the repository first; the commands below assume it lives at `/path/to/pylops-mcp`.
55
104
 
56
105
  #### 1. This project only