Back to Home
delian icon

codeguide-mcp

Verified Safe

by delian

Overview

An MCP server that provides coding guides and best practices to AI assistants, designed to extend or replace `AGENTS.md` files.

Installation

Run Command
docker run -i codeguide-mcp

Environment Variables

  • GUIDES_GITHUB_REPO
  • GUIDES_GITHUB_PATH
  • GUIDES_GITHUB_BRANCH
  • GUIDES_CACHE_DIR
  • GUIDES_DIR
  • GUIDES_LOG_LEVEL

Security Notes

The server includes basic path traversal prevention for requested guide names (e.g., disallowing '/' and '..'). It performs network requests using `httpx` to the GitHub API, which mitigates generic SSRF risks by hardcoding the domain. Content fetched from GitHub is base64 decoded. There are no clear indications of `eval` or other dynamic code execution patterns. Configuration values, including GitHub repository details, are read from `config.toml` or environment variables, preventing hardcoded secrets. Potential risks include serving malicious Markdown content (client-side rendering vulnerability) or if the GitHub repository configuration could be manipulated to a malicious source within GitHub's ecosystem, but these are outside the direct control of the server's code logic.

Similar Servers

Stats

Interest Score0
Security Score8
Cost ClassMedium
Avg Tokens2000
Stars0
Forks0
Last Update2026-01-18

Tags

MCPAI AssistantCoding GuidesBest PracticesGitHub IntegrationDeveloper ToolsContext ManagementCaching