pyslang-mcp
PYPI · PYSLANG-MCP
Compiler-backed read-only Verilog and SystemVerilog project analysis.
Available components
Last scanned (16 hours ago)
Scores higher than 75% of PyPI servers
Category Developer Tools
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security50
- Malware scan not yet available for this package.Unverified
- No known CVEs affecting this package version or its production dependencies.Pass
- Runs hatchling.build at install time, a recognised build step with no custom scripting around it. View diagnostics → Pass
- 0 of 29 dependencies flagged as unhealthy. View diagnostics → Pass
Provenance & Transparency97
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to ariklapid/pyslang-mcp). View diagnostics → Pass
- Clear OSI-approved license (Apache-2.0).Pass
- Actively maintained (last published 186 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability69
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 2637 tokens (~263/item across 10 items; 10 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 10 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 10 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Checks we ran (15)
- Known CVEs
- Install scripts
- Dependency health
- Source repository
- Provenance
- License
- Maintenance
- Security disclosure
- Schema quality
- Stability
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Checks we could not complete (1)
These are gaps on our side, not findings about this package. We only credit what we can confirm, so a category made up entirely of them scores 0.
- Malware scan in Supply Chain SecurityMalware scan not yet available for this package.
Does not apply to this package (2)
- Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
- Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 21 Nov 26 −15
- Malware scan: pass → unverified ▼ security
- 20 Nov 26 +15
- Malware scan: unverified → pass ▲ security
- 19 Nov 26 −15
- Malware scan: pass → unverified ▼ security
- 18 Nov 26 +16
- Malware scan: unverified → pass ▲ security
- Stability: 0.97 → pass security
- 17 Nov 26 −16
- Malware scan: pass → unverified ▼ security
- Stability: pass → 0.97 functional
- 16 Nov 26 +15
- Malware scan: unverified → pass ▲ security
- 15 Nov 26 −15
- Malware scan: pass → unverified ▼ security
- 11 Nov 26 +1
- Stability: 0.97 → pass security
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 21 Nov 2026 · Analysed pypi/pyslang-mcp@0.1.0
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | pypi |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | ariklapid/pyslang-mcp |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/ariklapid/pyslang-mcp/.github/workflows/release.yml@refs/heads/main |
| Rekor log index | 1567099088 |
| Predicate type | PyPI publish attestation https://docs.pypi.org/attestations/publish/v1 |
| Subject digest | sha256:d999f92674abe024edc79293b8887baaaecaf9b6a3563bd97264ce742e951745 |
Background: How many MCP packages publish verified provenance →
Install scripts 1 script
| Hook | Tier | Command |
|---|---|---|
| build_backend | Known build tool | hatchling.build |
Background: Why install scripts are a supply-chain risk →
Dependencies 29 packages
| Packages resolved | 29 |
|---|---|
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
pyslang_describe_design_unit ~280
Describe one project-local design unit by exact, case-sensitive name. Start with `pyslang_list_design_units` if you need discovery. The result reports `found` / `ambiguous`, candidate matches, and on success a `design_unit` object with ports, member-kind counts, child instances, and declared names.
| Name | Type | Req | Description |
|---|---|---|---|
| defines | – | – | Additional preprocessor defines. Use `{NAME: null}` for valueless defines and `{NAME: "VALUE"}` for explicit values. |
| filelist | – | – | Project-relative or absolute filelist path under `project_root`. Provide this or `files`, but not both. |
| files | – | – | Project-relative or absolute source file paths under `project_root`. Provide this or `filelist`, but not both. |
| include_dirs | – | – | Additional include directories under `project_root`. These are merged with any include directories discovered from a filelist. |
| name | string | yes | Exact, case-sensitive design-unit name. Call `pyslang_list_design_units` first if you need to discover the available names. |
| project_root | string | yes | Declared project root. Every source file, filelist, and include directory must resolve inside this directory or the tool returns an error. |
| top_modules | – | – | Optional top-module override passed into pyslang elaboration. Use when the project contains multiple candidate tops. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
pyslang_dump_syntax_tree_summary ~264
Summarize syntax-tree shapes per file without dumping full raw ASTs. Returns each file's root kind, top-level member kinds, include directives, and the most common node kinds up to `max_node_kinds`.
| Name | Type | Req | Description |
|---|---|---|---|
| defines | – | – | Additional preprocessor defines. Use `{NAME: null}` for valueless defines and `{NAME: "VALUE"}` for explicit values. |
| filelist | – | – | Project-relative or absolute filelist path under `project_root`. Provide this or `files`, but not both. |
| files | – | – | Project-relative or absolute source file paths under `project_root`. Provide this or `filelist`, but not both. |
| include_dirs | – | – | Additional include directories under `project_root`. These are merged with any include directories discovered from a filelist. |
| max_files | integer | – | Maximum number of files to summarize before truncation. |
| max_node_kinds | integer | – | Maximum distinct syntax node kinds to keep per file summary. |
| project_root | string | yes | Declared project root. Every source file, filelist, and include directory must resolve inside this directory or the tool returns an error. |
| top_modules | – | – | Optional top-module override passed into pyslang elaboration. Use when the project contains multiple candidate tops. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
pyslang_find_symbol ~356
Search declarations and references by symbol name, lexical path, or hierarchical path. `match_mode` accepts `exact`, `contains`, or `startswith`. Reference hits can include `named_value`, `package_import`, `instance_definition`, and `declared_type`; set `include_references=false` for a cheaper declaration-only query.
| Name | Type | Req | Description |
|---|---|---|---|
| defines | – | – | Additional preprocessor defines. Use `{NAME: null}` for valueless defines and `{NAME: "VALUE"}` for explicit values. |
| filelist | – | – | Project-relative or absolute filelist path under `project_root`. Provide this or `files`, but not both. |
| files | – | – | Project-relative or absolute source file paths under `project_root`. Provide this or `filelist`, but not both. |
| include_dirs | – | – | Additional include directories under `project_root`. These are merged with any include directories discovered from a filelist. |
| include_references | boolean | – | When true, walk the elaborated design to include reference hits. This is more expensive than declaration-only lookup on larger projects. |
| match_mode | string | – | Match mode for `query`: `exact` matches the full name or path, `contains` matches substrings, and `startswith` matches prefixes. |
| max_results | integer | – | Maximum declaration hits and maximum reference hits to return. |
| project_root | string | yes | Declared project root. Every source file, filelist, and include directory must resolve inside this directory or the tool returns an error. |
| query | string | yes | Symbol name, lexical path, or hierarchical path to match against declarations and optionally references. |
| top_modules | – | – | Optional top-module override passed into pyslang elaboration. Use when the project contains multiple candidate tops. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
pyslang_get_diagnostics ~243
Return parse and semantic diagnostics for a project described by explicit files or a filelist. Use this early to confirm the project loads cleanly; the result includes severity counts, per-diagnostic locations, and truncation metadata.
| Name | Type | Req | Description |
|---|---|---|---|
| defines | – | – | Additional preprocessor defines. Use `{NAME: null}` for valueless defines and `{NAME: "VALUE"}` for explicit values. |
| filelist | – | – | Project-relative or absolute filelist path under `project_root`. Provide this or `files`, but not both. |
| files | – | – | Project-relative or absolute source file paths under `project_root`. Provide this or `filelist`, but not both. |
| include_dirs | – | – | Additional include directories under `project_root`. These are merged with any include directories discovered from a filelist. |
| max_items | integer | – | Maximum number of list items to return before truncation. |
| project_root | string | yes | Declared project root. Every source file, filelist, and include directory must resolve inside this directory or the tool returns an error. |
| top_modules | – | – | Optional top-module override passed into pyslang elaboration. Use when the project contains multiple candidate tops. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
pyslang_get_hierarchy ~258
Return the elaborated instance hierarchy rooted at pyslang top instances. Use `max_depth` and `max_children` to control expansion; nodes include definitions, locations, port-connection snippets, and child truncation markers.
| Name | Type | Req | Description |
|---|---|---|---|
| defines | – | – | Additional preprocessor defines. Use `{NAME: null}` for valueless defines and `{NAME: "VALUE"}` for explicit values. |
| filelist | – | – | Project-relative or absolute filelist path under `project_root`. Provide this or `files`, but not both. |
| files | – | – | Project-relative or absolute source file paths under `project_root`. Provide this or `filelist`, but not both. |
| include_dirs | – | – | Additional include directories under `project_root`. These are merged with any include directories discovered from a filelist. |
| max_children | integer | – | Maximum child instances to return per hierarchy node. |
| max_depth | integer | – | Maximum hierarchy depth to expand from each top instance. |
| project_root | string | yes | Declared project root. Every source file, filelist, and include directory must resolve inside this directory or the tool returns an error. |
| top_modules | – | – | Optional top-module override passed into pyslang elaboration. Use when the project contains multiple candidate tops. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
pyslang_get_project_summary ~318
Return a compact project-wide summary of normalized inputs, diagnostics, design-unit counts, top instances, and tracked paths. The summary uses bounded internal limits; tune them with `max_diagnostics`, `max_design_units`, `max_depth`, and `max_children`.
| Name | Type | Req | Description |
|---|---|---|---|
| defines | – | – | Additional preprocessor defines. Use `{NAME: null}` for valueless defines and `{NAME: "VALUE"}` for explicit values. |
| filelist | – | – | Project-relative or absolute filelist path under `project_root`. Provide this or `files`, but not both. |
| files | – | – | Project-relative or absolute source file paths under `project_root`. Provide this or `filelist`, but not both. |
| include_dirs | – | – | Additional include directories under `project_root`. These are merged with any include directories discovered from a filelist. |
| max_children | integer | – | Maximum child instances per node in `pyslang_get_project_summary`. |
| max_depth | integer | – | Maximum hierarchy depth to fold into `pyslang_get_project_summary`. |
| max_design_units | integer | – | Maximum design units to fold into `pyslang_get_project_summary`. |
| max_diagnostics | integer | – | Maximum diagnostics to fold into `pyslang_get_project_summary`. |
| project_root | string | yes | Declared project root. Every source file, filelist, and include directory must resolve inside this directory or the tool returns an error. |
| top_modules | – | – | Optional top-module override passed into pyslang elaboration. Use when the project contains multiple candidate tops. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
pyslang_list_design_units ~245
List project-local modules, interfaces, and packages for the analyzed project. Use this as the discovery step before `pyslang_describe_design_unit`; results include stable names, kinds, paths, locations, and truncation metadata.
| Name | Type | Req | Description |
|---|---|---|---|
| defines | – | – | Additional preprocessor defines. Use `{NAME: null}` for valueless defines and `{NAME: "VALUE"}` for explicit values. |
| filelist | – | – | Project-relative or absolute filelist path under `project_root`. Provide this or `files`, but not both. |
| files | – | – | Project-relative or absolute source file paths under `project_root`. Provide this or `filelist`, but not both. |
| include_dirs | – | – | Additional include directories under `project_root`. These are merged with any include directories discovered from a filelist. |
| max_items | integer | – | Maximum number of list items to return before truncation. |
| project_root | string | yes | Declared project root. Every source file, filelist, and include directory must resolve inside this directory or the tool returns an error. |
| top_modules | – | – | Optional top-module override passed into pyslang elaboration. Use when the project contains multiple candidate tops. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
pyslang_parse_filelist ~215
Parse and elaborate a project filelist under a declared project root. Returns the normalized project configuration, parse counts, expanded nested filelists, and any unsupported filelist directives that were reported instead of ignored.
| Name | Type | Req | Description |
|---|---|---|---|
| defines | – | – | Additional preprocessor defines. Use `{NAME: null}` for valueless defines and `{NAME: "VALUE"}` for explicit values. |
| filelist | string | yes | Project-relative or absolute filelist path under `project_root`. Supports nested `-f` / `-F`, `+incdir+`, `-I`, and `+define+` entries. |
| include_dirs | – | – | Additional include directories under `project_root`. These are merged with any include directories discovered from a filelist. |
| project_root | string | yes | Declared project root. Every source file, filelist, and include directory must resolve inside this directory or the tool returns an error. |
| top_modules | – | – | Optional top-module override passed into pyslang elaboration. Use when the project contains multiple candidate tops. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
pyslang_parse_files ~200
Parse and elaborate an explicit list of Verilog or SystemVerilog files under a declared project root. Returns the normalized project configuration plus a compact parse summary with file, include, define, top-module, and diagnostic counts.
| Name | Type | Req | Description |
|---|---|---|---|
| defines | – | – | Additional preprocessor defines. Use `{NAME: null}` for valueless defines and `{NAME: "VALUE"}` for explicit values. |
| files | array | yes | Project-relative or absolute source file paths under `project_root`. Use this for explicit-file mode instead of `filelist`. |
| include_dirs | – | – | Additional include directories under `project_root`. These are merged with any include directories discovered from a filelist. |
| project_root | string | yes | Declared project root. Every source file, filelist, and include directory must resolve inside this directory or the tool returns an error. |
| top_modules | – | – | Optional top-module override passed into pyslang elaboration. Use when the project contains multiple candidate tops. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
pyslang_preprocess_files ~258
Return conservative preprocessing metadata and leading source excerpts for analyzed files. This is summary-only: it reports include directives and effective defines, but it does not claim to produce a full standalone preprocessed text stream.
| Name | Type | Req | Description |
|---|---|---|---|
| defines | – | – | Additional preprocessor defines. Use `{NAME: null}` for valueless defines and `{NAME: "VALUE"}` for explicit values. |
| filelist | – | – | Project-relative or absolute filelist path under `project_root`. Provide this or `files`, but not both. |
| files | – | – | Project-relative or absolute source file paths under `project_root`. Provide this or `filelist`, but not both. |
| include_dirs | – | – | Additional include directories under `project_root`. These are merged with any include directories discovered from a filelist. |
| max_excerpt_lines | integer | – | Maximum number of leading source lines to include per file excerpt. |
| max_files | integer | – | Maximum number of files to summarize before truncation. |
| project_root | string | yes | Declared project root. Every source file, filelist, and include directory must resolve inside this directory or the tool returns an error. |
| top_modules | – | – | Optional top-module override passed into pyslang elaboration. Use when the project contains multiple candidate tops. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
How do I install the pyslang-mcp server?
pyslang-mcp runs locally as a PyPI package, launched with uvx pyslang-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
pypi · pyslang-mcp
claude mcp add ariklapid-pyslang-mcp -- uvx pyslang-mcp
What is the pyslang-mcp server?
pyslang-mcp is listed in the public MCP registry as io.github.ariklapid/pyslang-mcp. Compiler-backed read-only Verilog and SystemVerilog project analysis. This page covers its PyPI package (pyslang-mcp).
Is the pyslang-mcp server safe to use?
pyslang-mcp scores 79 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the pyslang-mcp server expose?
pyslang-mcp exposes 10 tools: pyslang_parse_files, pyslang_parse_filelist, pyslang_get_diagnostics, pyslang_list_design_units, pyslang_describe_design_unit, and 5 more. Their descriptions and schemas cost roughly 2,637 tokens of context every time the server is loaded.
Is the pyslang-mcp server still maintained?
pyslang-mcp is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the pyslang-mcp server under?
pyslang-mcp declares the Apache-2.0 licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.
What did VerifyMCP test on the pyslang-mcp server?
VerifyMCP ran 15 checks on pyslang-mcp, covering Known CVEs, Install scripts, Dependency health, Source repository and 11 more. One item could not be completed, a gap on our side rather than a finding about pyslang-mcp: Malware scan. Endpoint Security and Transport & Reachability do not apply to a PyPI package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.