Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 29 additions & 0 deletions .codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
{
"name": "git-mcp",
"version": "0.1.0",
"description": "GitMCP plugin for Codex - eliminate code hallucinations with up-to-date GitHub project docs",
"author": {
"name": "idosal",
"url": "https://github.com/idosal"
},
"homepage": "https://gitmcp.io",
"repository": "https://github.com/idosal/git-mcp",
"license": "Apache-2.0",
"keywords": [
"mcp",
"git",
"github",
"documentation",
"reverse-engineering"
],
"mcpServers": "./.mcp.json",
"interface": {
"displayName": "GitMCP",
"shortDescription": "Access up-to-date GitHub project docs and code via MCP",
"longDescription": "GitMCP is a free, open-source remote MCP server that transforms any GitHub project into a documentation hub. Enables Codex to access current docs and source code, eliminating code hallucinations.",
"developerName": "idosal",
"category": "Productivity",
"websiteURL": "https://gitmcp.io"
},
"skills": "./skills/"
}
20 changes: 20 additions & 0 deletions .github/workflows/plugin-quality-gate.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
name: Plugin Quality Gate

on:
pull_request:
paths:
- ".codex-plugin/**"
- "skills/**"
- ".mcp.json"

jobs:
scan:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Codex plugin quality gate
uses: hashgraph-online/hol-codex-plugin-scanner-action@v1
with:
plugin_dir: "."
min_score: 80
fail_on_severity: high
8 changes: 8 additions & 0 deletions .mcp.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{
"mcpServers": {
"gitmcp": {
"type": "url",
"url": "https://gitmcp.io/docs"
}
}
}
25 changes: 25 additions & 0 deletions skills/git-mcp/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
name: git-mcp
description: Use GitMCP to access up-to-date GitHub project documentation and source code, eliminating code hallucinations.
---

# GitMCP for Codex

Access up-to-date documentation and source code from any GitHub project through the GitMCP remote MCP server.

## When to use

- You need current API docs, code examples, or usage patterns from a GitHub repo
- The user references a library or framework you want accurate information about
- You need to verify your knowledge against the actual source code

## Available servers

- **gitmcp (generic):** `https://gitmcp.io/docs` - AI picks the repo from context
- **Per-repo:** `https://gitmcp.io/{owner}/{repo}` - Scoped to a specific repository

## Tips

- For common libraries, the generic server works well
- For lesser-known or private repos, use the per-repo URL
- Combine with file reading for hybrid local + remote research