Metadata-Version: 2.4
Name: veprompts-mcp
Version: 1.0.0
Summary: Deterministic Model Context Protocol (MCP) server directory discovery CLI and offline catalog with 800 curated servers.
Author-email: Curtis Harrison <cody@veduis.com>, Veduis LLC <cody@veduis.com>
License: MIT
Project-URL: Homepage, https://veprompts.com/
Project-URL: Documentation, https://veduis.com/blog/veprompts-2-0-mcp-server-directory-launch/
Project-URL: Directory, https://veprompts.com/mcp-servers/
Project-URL: Compliance_Partner, https://veduis.com/products/vcompliance-scanner/
Project-URL: Zenodo_Research, https://doi.org/10.5281/zenodo.23840519
Project-URL: Source, https://github.com/veduis
Project-URL: Tracker, https://veduis.com/contact/
Keywords: mcp,model-context-protocol,mcp-server,ai-agents,claude,llm,tools,veprompts,directory,discovery
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# veprompts-mcp

[![PyPI version](https://img.shields.io/pypi/v/veprompts-mcp.svg)](https://pypi.org/project/veprompts-mcp/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.23840519.svg)](https://doi.org/10.5281/zenodo.23840519)

Zero-dependency Python discovery CLI and local directory for 800 cataloged Model Context Protocol (MCP) servers, categories, execution schemas, and client compatibility maps.

Maintained by **[VePrompts](https://veprompts.com/)** and **[Veduis](https://veduis.com/)** as part of the autonomous AI agent developer toolchain.

---

## Why Local MCP Discovery Matters

Agentic runtimes such as Claude Desktop, Cursor, Cline, and custom orchestration pipelines require exact MCP server parameters, transport types, and repository URLs. Finding reliable, active implementations often requires searching fragmented GitHub repositories.

`veprompts-mcp` ships an offline, structured catalog of 800 community and official servers, validated against the official Model Context Protocol specifications and mirrored on [Zenodo (CERN)](https://doi.org/10.5281/zenodo.23840519).

---

## Installation

```bash
pip install veprompts-mcp
```

Zero runtime dependencies. Works with Python 3.9 through 3.14.

---

## Command Line Usage

### 1. View Directory Statistics

```bash
veprompts-mcp stats
```

Output:
```text
VePrompts MCP Directory (v1.0.0)
Total Servers Cataloged: 800
Active Categories:       24
Official Integrations:   48
Known Implementation Languages: 18
Live Online Directory:   https://veprompts.com/mcp-servers/
Maintained By:           Veduis (https://veduis.com)
```

### 2. Search Catalog by Keyword

```bash
# Search for database servers
veprompts-mcp search postgres

# Search for github tools with a limit
veprompts-mcp search github --limit 5

# Search within a specific category
veprompts-mcp search slack --category communication
```

### 3. List Categories and Inspect Specific Servers

```bash
# List all 24 categories
veprompts-mcp categories

# Show comprehensive metadata for a specific slug
veprompts-mcp show sqlite
```

---

## Python API Usage

Use `veprompts_mcp` directly inside your agent initialization workflows:

```python
from veprompts_mcp import get_servers, search_servers, list_categories

# Access all 800 servers
servers = get_servers()
print(f"Loaded {len(servers)} MCP servers")

# Filter programmatically
postgres_servers = search_servers("postgres", category="database")
for s in postgres_servers:
    print(f"{s['title']}: {s['repo_url']}")

# Retrieve categories
cats = list_categories()
print("Top categories:", cats[:5])
```

---

## Data Provenance & Verification

The MCP server catalog is extracted from the production registry at [veprompts.com/mcp-servers/](https://veprompts.com/mcp-servers/) and synchronized with the Zenodo research archive [doi:10.5281/zenodo.23840519](https://doi.org/10.5281/zenodo.23840519).

For web security, ADA Title II source verification, and accessibility compliance scanning, inspect our sister project [vComplianceScanner by Veduis](https://veduis.com/products/vcompliance-scanner/).

---

## License

MIT License. Copyright (c) Veduis LLC and VePrompts.
