Metadata-Version: 2.4
Name: agentic-store-mcp
Version: 0.3.0
Summary: Open-source MCP tools for AI agents — lint, security, dependency audit, web scraping and more
Project-URL: Homepage, https://github.com/agenticstore/agenticstore-mcp-tools
Project-URL: Issues, https://github.com/agenticstore/agenticstore-mcp-tools/issues
License: MIT
Keywords: agents,ai,lint,mcp,security,tools
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.12
Requires-Dist: mcp>=1.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# AgenticStore MCP Tools

Free, open-source MCP tools for AI agents — self-hosted, no account required, no API keys for core tools.

Works with **Claude Desktop**, **Cursor**, **Windsurf**, **VS Code**, and any MCP-compatible client.

---

## What's Included

| Module | Tools | What it does |
|--------|-------|-------------|
| **AgenticCode** | `python_lint_checker` | Static analysis for Python — bugs, style, complexity |
| **AgenticCode** | `repo_scanner` | Scan for leaked secrets, PII, and .gitignore gaps |
| **AgenticCode** | `dependency_audit` | Check for outdated and vulnerable dependencies |
| **AgenticData** | `agentic_web_search` | SEO signal extractor — metadata, OG, Twitter Card, headings, word count |

---

## Installation

### Step 1 — Install `uv`

`uv` is the Python package manager used to run and install this toolkit.

**macOS / Linux**
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

**Windows (PowerShell)**
```powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```

**Windows (winget)**
```powershell
winget install --id=astral-sh.uv -e
```

Verify the install:
```bash
uv --version
```

---

### Step 2 — Install AgenticStore MCP Tools

**Option A — Run directly (no install needed)**

```bash
uvx agentic-store-mcp
```

`uvx` downloads and runs the latest version in an isolated environment. Nothing is installed globally.

**Option B — Install with pip**

```bash
pip install agentic-store-mcp
```

---

## Start the Server

Once installed, start the MCP server from your terminal:

```bash
# All tools
uvx agentic-store-mcp

# AgenticCode tools only (lint, scan, audit)
uvx agentic-store-mcp --modules code

# AgenticData tools only (web search, SEO)
uvx agentic-store-mcp --modules data

# Multiple modules
uvx agentic-store-mcp --modules code,data

# Single tool
uvx agentic-store-mcp --tools agentic_web_search

# List all available tools and exit
uvx agentic-store-mcp --list
```

If you installed via `pip`, replace `uvx agentic-store-mcp` with `agentic-store-mcp` in all commands above.

The server runs over **stdio** and stays alive until your AI client disconnects.

---

## Connect to Your AI Client

Add the server to your AI client's config file, then restart the client.

### Claude Desktop

**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "agenticstore": {
      "command": "uvx",
      "args": ["agentic-store-mcp", "--modules", "code,data"]
    }
  }
}
```

### Cursor

`~/.cursor/mcp.json`

```json
{
  "mcpServers": {
    "agenticstore": {
      "command": "uvx",
      "args": ["agentic-store-mcp", "--modules", "code,data"]
    }
  }
}
```

### Windsurf

`~/.codeium/windsurf/mcp_config.json`

```json
{
  "mcpServers": {
    "agenticstore": {
      "command": "uvx",
      "args": ["agentic-store-mcp", "--modules", "code,data"]
    }
  }
}
```

### VS Code (with MCP extension)

```json
{
  "mcpServers": {
    "agenticstore": {
      "command": "uvx",
      "args": ["agentic-store-mcp", "--modules", "code,data"]
    }
  }
}
```

---

## Run from Source

Prefer cloning the repo? This also works:

```bash
# 1. Clone
git clone https://github.com/agenticstore/agenticstore-mcp-tools
cd agenticstore-mcp-tools

# 2. Install dependencies
uv sync

# 3. Start the server
uv run server.py

# Start with specific modules or tools
uv run server.py --modules code,data
uv run server.py --tools agentic_web_search
uv run server.py --list
```

Point your AI client config at the local clone:

```json
{
  "mcpServers": {
    "agenticstore": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/agenticstore-mcp-tools", "server.py"]
    }
  }
}
```

---

## Programmatic Usage (Python)

Embed the server directly in a Python script:

```python
from agentic_store_mcp import start_server

start_server()                             # all tools
start_server(modules=["code"])             # AgenticCode only
start_server(modules=["code", "data"])     # multiple modules
start_server(tools=["agentic_web_search"]) # single tool
```

Or wire it into a Claude Desktop config:

```json
{
  "mcpServers": {
    "agenticstore": {
      "command": "python3",
      "args": ["-c", "from agentic_store_mcp import start_server; start_server()"]
    }
  }
}
```

---

## Tool Reference

### `python_lint_checker`
Static analysis for Python files. Checks imports, bugs, style, and complexity — zero external dependencies.

### `repo_scanner`
Scans a directory for leaked secrets (AWS keys, API tokens, private keys), PII (emails, SSNs), and missing `.gitignore` entries.

### `dependency_audit`
Audits `requirements.txt`, `pyproject.toml`, `package.json`, `go.mod`, `pom.xml`, and more. Checks for outdated versions and known CVEs via OSV.

### `agentic_web_search`
Fetches any URL and returns a full SEO signal report: title, meta description, canonical URL, robots directives, Open Graph tags, Twitter Card tags, heading structure, word count, and internal/external link breakdown.

---

## Contributing

- Tools must be **pure Python** — no external API calls, no managed services
- Each tool lives in `modules/<category>/<tool_name>/` with `handler.py`, `schema.json`, and `README.md`
- Run tests: `uv run pytest`

---

## License

MIT — free to use, fork, and modify.
