AST-based Model Context Protocol (MCP) server for token-efficient codebase exploration.
About
An AST-based Model Context Protocol (MCP) server that provides token-efficient codebase skeletons to LLM agents (like Cursor, Claude Desktop, and Antigravity).
Instead of sending full raw source code files to the LLM, this server exposes structural "skeletons" (imports, exports, signatures, and JSDoc comments) of files and directories. This reduces token context sizes by 80% to 95% during codebase exploration and navigation.
Security Report
This MCP server is well-structured with proper authentication and appropriate permissions for its stated purpose. It requires API key validation via environment variables, uses standard MCP protocol patterns, and makes authenticated HTTP calls to a backend service. No malicious patterns, credential leaks, or dangerous operations detected. Minor code quality observations exist but do not materially impact security. Supply chain analysis found 1 known vulnerability in dependencies. Package verification found 1 issue.
5 files analyzed · 6 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: PENQWIN_API_KEY
Environment variable: PENQWIN_ORG_ID
Environment variable: PENQWIN_REPO
How to Install & Connect
Available as Local & Remote
This plugin can run on your machine or connect to a hosted endpoint. during install.
Getting Started
Once installed, try these example prompts and explore these capabilities:
- 1"What functions call ProcessPayment?"
Documentation
View on GitHubFrom the project's GitHub README.
@penqwin/mcp
An AST-based Model Context Protocol (MCP) server that provides token-efficient codebase skeletons to LLM agents (like Cursor, Claude Desktop, and Antigravity).
Instead of sending full raw source code files to the LLM, this server exposes structural "skeletons" (imports, exports, signatures, and JSDoc comments) of files and directories. This reduces token context sizes by 80% to 95% during codebase exploration and navigation.
Features & Tools
The server registers 5 core tools with the MCP protocol:
| Tool Name | Description |
|---|---|
get_repo_index | Returns a compact Table of Contents of the repository (all files + top-level exported names). ~10–20 tokens/file. |
get_folder_skeleton | Retrieves structural skeletons for all files matching a directory/folder prefix. |
get_file_skeleton | Retrieves the detailed structural skeleton (signatures, types, methods, parameters, and JSDocs) of a single file. |
search_symbols | Queries the AST index to find files that export a specific class, function, struct, or type. |
get_repo_stats | Returns aggregate statistics of the repository, including file counts and language breakdown. |
Configuration
The MCP server is configured entirely via environment variables.
| Environment Variable | Description | Example |
|---|---|---|
PENQWIN_API_KEY | Machine-to-machine API key generated from the DB | ed_live_0e21cf14... |
PENQWIN_ORG_ID | The organization ID associated with the API key | 0db9f7b5-7206-... |
PENQWIN_REPO | The repository owner and name to target | <org_name>/<repo_name> |
PENQWIN_API_URL | The REST API gateway URL of the penqwin backend | http://app.penqwin.com |
IDE Integrations
You can integrate this MCP server with your favorite IDE using either npx (highly recommended for end-users, as it doesn't require cloning/building) or by pointing to your local build.
1. Direct Integration (via npm/npx)
This is the easiest setup for users. The IDE will automatically fetch and run the latest version of the package.
Cursor
Go to Cursor Settings -> Features -> MCP, and click + Add New MCP Server:
- Name:
penqwin - Type:
command - Command:
npx -y @penqwin/mcp - Add the required environment variables under the env settings.
Antigravity / Gemini Code Assistant
Add this to your mcp_config.json:
{
"mcpServers": {
"penqwin": {
"command": "npx",
"args": ["-y", "@penqwin/mcp"],
"env": {
"PENQWIN_API_KEY": "your_api_key",
"PENQWIN_ORG_ID": "your_org_id",
"PENQWIN_REPO": "your_repo",
"PENQWIN_API_URL": "https://app.penqwin.com"
}
}
}
}
Claude Desktop
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"penqwin": {
"command": "npx",
"args": ["-y", "@penqwin/mcp"],
"env": {
"PENQWIN_API_KEY": "your_api_key",
"PENQWIN_ORG_ID": "your_org_id",
"PENQWIN_REPO": "your_repo",
"PENQWIN_API_URL": "https://app.penqwin.com"
}
}
}
}
2. Local Source Integration
If you have cloned the repository locally and compiled it:
Cursor
- Command:
node d:/Projects/EngDoc/eng-doc-mcp/dist/index.js(Use forward slashes for Windows paths)
Antigravity / Claude Desktop
- Command:
node - Args:
["d:/Projects/EngDoc/eng-doc-mcp/dist/index.js"]
Learn more:
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.