openai-mcp-client
- agent-framework
About
What is openai-mcp-client?
openai-mcp-client is a command-line Node.js application that integrates the GitHub MCP (Model Context Protocol) server with OpenAI, allowing developers to interact with GitHub repositories using natural language queries and commands.
How to use openai-mcp-client?
Install the GitHub MCP server globally via npm (npm install -g @modelcontextprotocol/server-github). Generate a GitHub Personal Access Token and obtain the executable path of the MCP server (e.g., which mcp-server-github). Then run node client.js for simple tool calls or node client-with-openai.js "your query" to use OpenAI‑powered interactions.
Key features of openai-mcp-client
- Integrates GitHub MCP server with OpenAI for natural language commands.
- Supports creating repositories, pushing code, making issues, branches, and pull requests.
- Offers a simple mode for single tool calls without OpenAI.
- Enables querying GitHub data, such as commit counts, via AI prompts.
Use cases of openai-mcp-client
- Ask "How many commits does my openai-mcp-client repo have?" and receive an AI‑generated answer.
- Instruct the client to create a new repository, add an HTML page, push changes, and open an issue – all from one natural language request.
- Automate GitHub workflows like branching, editing files, and creating pull requests through conversational commands.
FAQ from openai-mcp-client
What does openai-mcp-client do?
It acts as a bridge between GitHub (via MCP) and OpenAI, enabling you to manage GitHub resources by typing plain English instructions.
How do I install and configure the GitHub MCP server?
Run npm install -g @modelcontextprotocol/server-github, generate a GitHub Personal Access Token, and find the server path using which mcp-server-github (or equivalent on Windows).
Can openai-mcp-client be used with MCP servers other than GitHub?
The README only documents integration with the GitHub MCP server; support for other servers is not described.
What are the two operational modes of openai-mcp-client?
Simple mode (node client.js) calls a single GitHub tool directly. OpenAI integration mode (node client-with-openai.js "query") processes natural language through OpenAI to orchestrate multiple GitHub actions.
Is openai-mcp-client free or open‑source?
The README does not specify pricing or licensing information.
—
Details
- Author
- leartbeqiraj1
- GitHub stars
- 6
- Category
- agent-framework
- Repository
- leartbeqiraj1/openai-mcp-client
openai-mcp-client
Install mcp server for GitHub:
npm install -g @modelcontextprotocol/server-github
You need to configure two variables:
1. Generate a GitHub Personal Access Token
2. Get path to the MCP server executable (used for StdioClientTransport command):
which mcp-server-github
You can run the app on simple mode, which will call a single tool from GitHub MCP Server:
node client.js
Or you can integrate it with OpenAI and it allows you to interact with your GitHub profile through AI-powered queries. Examples below:
Example 1:
node client-with-openai.js "How many commits does my openai-mcp-client repo have that is under my username leartbeqiraj1?"
Example 2:
node client-with-openai.js "Please do the following: make a simple html page. create a repository called 'openai-created-this-repo'. Push the html page to the 'openai-created-this-repo' repository. Add a little css to the html page and then push it up. Make an issue suggesting we add some more content on the html page. Now make a branch called feature and make that fix and push the change. Make a pull request against main with these changes."
