workos-github-mcp-server 1.0.0__tar.gz

workos_github_mcp_server-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WorkOS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

workos_github_mcp_server-1.0.0/PKG-INFO

@@ -0,0 +1,194 @@
+Metadata-Version: 2.4
+Name: workos-github-mcp-server
+Version: 1.0.0
+Summary: MCP server for GitHub operations — manage repos, issues, pull requests, commits, gists, and more.
+Author: WorkOS Contributors
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/workos/workos-github-mcp-server
+Project-URL: Repository, https://github.com/workos/workos-github-mcp-server
+Project-URL: Issues, https://github.com/workos/workos-github-mcp-server/issues
+Keywords: mcp,github,model-context-protocol,ai-tools,devtools
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastmcp>=2.0.0
+Requires-Dist: httpx>=0.27.0
+Dynamic: license-file
+
+# GitHub MCP Server
+
+<!-- mcp-name: io.github.workos/github-mcp-server -->
+
+A production-ready [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for GitHub operations. Connect any AI agent to GitHub — manage repos, issues, pull requests, commits, gists, search code, and look up user profiles.
+
+**This is an independent, generalized MCP server.** It is not tied to any specific project and can be connected to any AI agent that supports MCP (Claude Desktop, Cursor, WorkOS, or custom agents).
+
+## Features
+
+- 📦 **Repositories**: List, search, and get repo details
+- 🐛 **Issues**: Create, read, update, search issues
+- 🔀 **Pull Requests**: List, create, and inspect PRs
+- 📝 **Commits**: Browse commit history
+- 🔍 **Search**: Search code and issues across GitHub
+- 👤 **Users**: Look up user profiles
+- 📋 **Gists**: List and create gists
+
+## Installation
+
+```bash
+pip install workos-github-mcp-server
+```
+
+Or install from source:
+```bash
+git clone https://github.com/workos/workos-github-mcp-server
+cd workos-github-mcp-server
+pip install -e .
+```
+
+## Quick Start
+
+```bash
+export GITHUB_TOKEN="ghp_your-personal-access-token"
+
+# Run the server
+github-mcp-server
+
+# Or run as a Python module
+python -m github_mcp_server
+```
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `GITHUB_TOKEN` | ✅ Yes | GitHub Personal Access Token (`ghp_...` or `github_pat_...`) |
+
+### Getting a GitHub Token
+
+1. Go to [github.com/settings/tokens](https://github.com/settings/tokens)
+2. Click **"Generate new token (classic)"** or **"Fine-grained tokens"**
+3. Select scopes:
+   - `repo` — full repository access (issues, PRs, commits)
+   - `gist` — create and list gists
+   - `read:user` — read user profiles
+4. Copy the generated token
+
+## Connecting to AI Agents
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "github": {
+      "command": "github-mcp-server",
+      "env": {
+        "GITHUB_TOKEN": "ghp_your-token"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "github": {
+      "command": "github-mcp-server",
+      "env": {
+        "GITHUB_TOKEN": "ghp_your-token"
+      }
+    }
+  }
+}
+```
+
+### WorkOS / Custom Agents
+
+Add to `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "github": {
+      "transport": "stdio",
+      "command": "python",
+      "args": ["-m", "github_mcp_server"],
+      "env": {
+        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
+      }
+    }
+  }
+}
+```
+
+## Available Tools (15)
+
+| Tool | Description |
+|------|-------------|
+| `github_list_repos` | List repositories for a user or the authenticated user |
+| `github_get_repo` | Get detailed repository information |
+| `github_search_repos` | Search repositories across GitHub |
+| `github_list_issues` | List issues in a repository |
+| `github_create_issue` | Create a new issue |
+| `github_get_issue` | Get issue details |
+| `github_update_issue` | Update an existing issue |
+| `github_search_issues` | Search issues and PRs across GitHub |
+| `github_list_pull_requests` | List pull requests in a repository |
+| `github_get_pull_request` | Get pull request details |
+| `github_create_pull_request` | Create a new pull request |
+| `github_list_commits` | List recent commits |
+| `github_list_gists` | List gists for the authenticated user |
+| `github_create_gist` | Create a new gist |
+| `github_get_user` | Get user profile information |
+
+## Development
+
+```bash
+git clone https://github.com/workos/workos-github-mcp-server
+cd workos-github-mcp-server
+pip install -e .
+
+# Run tests
+pytest
+
+# Run the server locally
+GITHUB_TOKEN=ghp_test python -m github_mcp_server
+```
+
+## Publishing
+
+### To PyPI
+```bash
+pip install build twine
+python -m build
+twine upload dist/*
+```
+
+### To MCP Registry
+```bash
+mcp-publisher login github
+mcp-publisher publish
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.

workos_github_mcp_server-1.0.0/README.md

@@ -0,0 +1,168 @@
+# GitHub MCP Server
+
+<!-- mcp-name: io.github.workos/github-mcp-server -->
+
+A production-ready [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for GitHub operations. Connect any AI agent to GitHub — manage repos, issues, pull requests, commits, gists, search code, and look up user profiles.
+
+**This is an independent, generalized MCP server.** It is not tied to any specific project and can be connected to any AI agent that supports MCP (Claude Desktop, Cursor, WorkOS, or custom agents).
+
+## Features
+
+- 📦 **Repositories**: List, search, and get repo details
+- 🐛 **Issues**: Create, read, update, search issues
+- 🔀 **Pull Requests**: List, create, and inspect PRs
+- 📝 **Commits**: Browse commit history
+- 🔍 **Search**: Search code and issues across GitHub
+- 👤 **Users**: Look up user profiles
+- 📋 **Gists**: List and create gists
+
+## Installation
+
+```bash
+pip install workos-github-mcp-server
+```
+
+Or install from source:
+```bash
+git clone https://github.com/workos/workos-github-mcp-server
+cd workos-github-mcp-server
+pip install -e .
+```
+
+## Quick Start
+
+```bash
+export GITHUB_TOKEN="ghp_your-personal-access-token"
+
+# Run the server
+github-mcp-server
+
+# Or run as a Python module
+python -m github_mcp_server
+```
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `GITHUB_TOKEN` | ✅ Yes | GitHub Personal Access Token (`ghp_...` or `github_pat_...`) |
+
+### Getting a GitHub Token
+
+1. Go to [github.com/settings/tokens](https://github.com/settings/tokens)
+2. Click **"Generate new token (classic)"** or **"Fine-grained tokens"**
+3. Select scopes:
+   - `repo` — full repository access (issues, PRs, commits)
+   - `gist` — create and list gists
+   - `read:user` — read user profiles
+4. Copy the generated token
+
+## Connecting to AI Agents
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "github": {
+      "command": "github-mcp-server",
+      "env": {
+        "GITHUB_TOKEN": "ghp_your-token"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "github": {
+      "command": "github-mcp-server",
+      "env": {
+        "GITHUB_TOKEN": "ghp_your-token"
+      }
+    }
+  }
+}
+```
+
+### WorkOS / Custom Agents
+
+Add to `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "github": {
+      "transport": "stdio",
+      "command": "python",
+      "args": ["-m", "github_mcp_server"],
+      "env": {
+        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
+      }
+    }
+  }
+}
+```
+
+## Available Tools (15)
+
+| Tool | Description |
+|------|-------------|
+| `github_list_repos` | List repositories for a user or the authenticated user |
+| `github_get_repo` | Get detailed repository information |
+| `github_search_repos` | Search repositories across GitHub |
+| `github_list_issues` | List issues in a repository |
+| `github_create_issue` | Create a new issue |
+| `github_get_issue` | Get issue details |
+| `github_update_issue` | Update an existing issue |
+| `github_search_issues` | Search issues and PRs across GitHub |
+| `github_list_pull_requests` | List pull requests in a repository |
+| `github_get_pull_request` | Get pull request details |
+| `github_create_pull_request` | Create a new pull request |
+| `github_list_commits` | List recent commits |
+| `github_list_gists` | List gists for the authenticated user |
+| `github_create_gist` | Create a new gist |
+| `github_get_user` | Get user profile information |
+
+## Development
+
+```bash
+git clone https://github.com/workos/workos-github-mcp-server
+cd workos-github-mcp-server
+pip install -e .
+
+# Run tests
+pytest
+
+# Run the server locally
+GITHUB_TOKEN=ghp_test python -m github_mcp_server
+```
+
+## Publishing
+
+### To PyPI
+```bash
+pip install build twine
+python -m build
+twine upload dist/*
+```
+
+### To MCP Registry
+```bash
+mcp-publisher login github
+mcp-publisher publish
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.

workos_github_mcp_server-1.0.0/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "workos-github-mcp-server"
+version = "1.0.0"
+description = "MCP server for GitHub operations — manage repos, issues, pull requests, commits, gists, and more."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "WorkOS Contributors" }
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Software Development :: Version Control :: Git",
+]
+keywords = ["mcp", "github", "model-context-protocol", "ai-tools", "devtools"]
+
+dependencies = [
+    "fastmcp>=2.0.0",
+    "httpx>=0.27.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/workos/workos-github-mcp-server"
+Repository = "https://github.com/workos/workos-github-mcp-server"
+Issues = "https://github.com/workos/workos-github-mcp-server/issues"
+
+[project.scripts]
+github-mcp-server = "github_mcp_server:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-dir]
+"" = "src"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"

workos_github_mcp_server-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

workos_github_mcp_server-1.0.0/src/github_mcp_server/__init__.py

@@ -0,0 +1,26 @@
+"""
+GitHub MCP Server — Model Context Protocol server for GitHub operations.
+
+An independent, generalized MCP server that can connect to any AI agent
+supporting the Model Context Protocol. Not tied to any specific project.
+
+Quick start:
+    pip install workos-github-mcp-server
+    GITHUB_TOKEN=ghp_... github-mcp-server
+
+Or run as a module:
+    python -m github_mcp_server
+"""
+
+__version__ = "1.0.0"
+
+from github_mcp_server.server import create_server
+
+
+def main():
+    """Entry point for the github-mcp-server CLI command."""
+    server = create_server()
+    server.run()
+
+
+__all__ = ["main", "create_server", "__version__"]

workos_github_mcp_server-1.0.0/src/github_mcp_server/__main__.py

@@ -0,0 +1,4 @@
+"""Allow running as: python -m github_mcp_server"""
+from github_mcp_server import main
+
+main()