https://github.com/timescale/tiger-gh-mcp-server
Tiger GitHub MCP server
https://github.com/timescale/tiger-gh-mcp-server
Last synced: 9 months ago
JSON representation
Tiger GitHub MCP server
- Host: GitHub
- URL: https://github.com/timescale/tiger-gh-mcp-server
- Owner: timescale
- Created: 2025-07-16T17:01:33.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-10-06T20:18:50.000Z (9 months ago)
- Last Synced: 2025-10-06T20:30:04.882Z (9 months ago)
- Language: TypeScript
- Size: 160 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Tiger GitHub MCP Server
A wrapper around the GitHub API to provide some focused tools to LLMs via the [Model Context Protocol](https://modelcontextprotocol.io/introduction).
## Development
Cloning and running the server locally.
```bash
git clone git@github.com:timescale/tiger-gh-mcp-server.git
```
### Building
Run `npm i` to install dependencies and build the project. Use `npm run watch` to rebuild on changes.
You will need a GitHub token with the correct scopes. Here is a direct link to [create such a new token](https://github.com/settings/tokens/new?scopes=repo,read:org,read:user,user:email&description=tiger-gh-mcp-server).
Create a `.env` file based on the `.env.sample` file.
```bash
cp .env.sample .env
```
Then update the `GITHUB_TOKEN` value in `.env`.
### VS Code Debugging
The project includes a VS Code debug profile called "Debug Github MCP" that:
1. Installs dependencies (`npm i`)
2. Builds the project (`npm run build`)
3. Launches the server in HTTP mode with full debugging support
To use it:
- Open the project in VS Code
- Go to the Debug panel (Ctrl/Cmd + Shift + D)
- Select "Debug Github MCP" from the dropdown
- Press F5 or click the play button
Breakpoints will work properly in TypeScript source files thanks to source map support.
### Testing
The MCP Inspector is a very handy to exercise the MCP server from a web-based UI.
```bash
npx @modelcontextprotocol/inspector
```
| Field | Value |
| -------------- | --------------- |
| Transport Type | `STDIO` |
| Command | `node` |
| Arguments | `dist/index.js` |
#### Testing in Claude Desktop
Create/edit the file `~/Library/Application Support/Claude/claude_desktop_config.json` to add an entry like the following, making sure to use the absolute path to your local `tiger-gh-mcp-server` project, and use a valid GitHub token.
```json
{
"mcpServers": {
"tiger-gh": {
"command": "node",
"args": ["/absolute/path/to/tiger-gh-mcp-server/dist/index.js", "stdio"],
"env": {
"GITHUB_TOKEN": "ghp_whatever",
"GITHUB_ORG": "timescale"
}
}
}
}
```