一个围绕GitHub API的包装器，通过模型上下文协议为大型语言模型提供一些重点工具。

发展

克隆并本地运行服务器。

建筑

该项目使用 bun 作为运行时和包管理器。A 包含一个封装脚本（[./bun），用于下载置顶的 bun 版本 第一次使用，所以不需要全局安装。

运行./bun install安装依赖。使用./bun run watch http运行 服务器处于HTTP模式，并在更改时重新加载。

你需要一个带有正确作用范围的 GitHub 令牌。这里有一个直接链接，可以创建这样一个新令牌。

基于.env.sample文件创建一个.env文件。

然后更新 GITHUB_TOKEN 中的 GITHUB_TOKEN 值。

VS 代码调试

该项目包含一个名为“Debug Github MCP”的VS Code调试配置文件， 以HTTP模式启动服务器，并支持完整的调试，运行 TypeScript 直接通过 bun 源代码。

使用方法：

• 在 VS Code 中打开项目
• 进入调试面板（Ctrl/Cmd + Shift + D）
• 从下拉菜单中选择“调试 Github MCP”
• 按F5或点击播放键

得益于源映射支持，断点在 TypeScript 源文件中能正常工作。

测试

Tiger GitHub MCP Server

A wrapper around the GitHub API to provide some focused tools to LLMs via the Model Context Protocol.

Development

Cloning and running the server locally.

git clone [email protected]:timescale/tiger-gh-mcp-server.git

Building

This project uses bun as its runtime and package manager. A wrapper script (./bun) is included that downloads a pinned version of bun on first use, so you don’t need to install it globally.

Run ./bun install to install dependencies. Use ./bun run watch http to run the server in HTTP mode and reload on changes.

You will need a GitHub token with the correct scopes. Here is a direct link to create such a new token.

Create a .env file based on the .env.sample file.

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 launches the server in HTTP mode with full debugging support, running the TypeScript source directly via bun.

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.

./bun run inspector

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.

{
  "mcpServers": {
    "tiger-gh": {
      "command": "/absolute/path/to/tiger-gh-mcp-server/bun",
      "args": [
        "/absolute/path/to/tiger-gh-mcp-server/src/index.ts",
        "stdio"
      ],
      "env": {
        "GITHUB_TOKEN": "ghp_whatever",
        "GITHUB_ORG": "timescale"
      }
    }
  }
}