Mcp_client_server

GitHub 的 OpenAI MCP 客户端 这是一个 Node.js 命令行应用，可通过模型上下文协议（MCP）服务与 GitHub 集成，并调用 OpenAI API。用户可以执行 GitHub 操作（例如创建存储库、列出存储库），也可以借助 MCP 服务提供的上下文，向 OpenAI 查询 GitHub 相关信息。 功能

GitHub 操作： 创建新存储库。 列出所有存储库。 列出 GitHub API 端点。

OpenAI 集成： 借助 MCP 服务提供的 GitHub 上下文查询 OpenAI，获取详细解答（例如，“如何创建拉取请求”）。

交互式 CLI： 用于输入命令的简单命令行界面。

安全配置： 使用环境变量存储 API 密钥。

先决条件

Node.js：版本 14 或更高版本（推荐：最新的 LTS 版本）。 npm：随 Node.js 一同安装。 GitHub 个人访问令牌：访问 GitHub API 所必需。 OpenAI API 密钥：执行 OpenAI 查询所必需。 Git：用于版本控制并推送到 GitHub。

安装

克隆存储库： git clone https://github.com/[your-username]/tessst.git cd tessst

安装依赖项： npm install

这会安装 axios 和 dotenv（下文会添加）。

设置环境变量：

在项目根目录中创建 .env 文件：touch .env

添加 API 密钥：OPENAI_API_KEY=your_openai_api_key GITHUB_PERSONAL_ACCESS_TOKEN=your_github_personal_access_token

注意：切勿将 .env 提交到 GitHub。它已在 .gitignore 中被忽略。

安装 MCP 服务：

脚本使用 @modelcontextprotocol/server-github。它会通过 npx 按需安装，因此无需额外设置。

用法

运行应用： node openai-mcp-client.js

这会启动交互式 CLI。

可用命令：

创建新存储库：create new repo named my-repo

列出所有存储库：list all repositories

列出 GitHub API 端点：list github api

查询 OpenAI：how to create a pull request

退出：exit

交互示例：

create new repo named test-repo 已成功创建新存储库：https://github.com/[your-username]/test-repo list all repositories 你的存储库：

• tessst：通过 MCP 客户端于 2025-05-03 创建的存储库（https://github.com/[your-username]/tessst）
• test-repo：通过 MCP 客户端于 2025-05-03 创建的存储库（https://github.com/[your-username]/test-repo）

how to create a pull request OpenAI 的回复： 要在 GitHub 上创建拉取请求：

1. 将更改推送到一个分支...

项目结构

openai-mcp-client.js：包含 CLI 以及 GitHub/OpenAI 逻辑的主脚本。 .gitignore：忽略 node_modules/、.env、日志和系统文件。 .env：存储 API 密钥（不受 Git 跟踪）。 package.json：定义依赖项和脚本。

依赖项

axios：用于向 GitHub 和 OpenAI API 发送 HTTP 请求。 dotenv：用于从 .env 加载环境变量。

使用 dotenv 更新 package.json： npm install dotenv

安全注意事项

API 密钥：将 OPENAI_API_KEY 和 GITHUB_PERSONAL_ACCESS_TOKEN 存储在 .env 中，而非代码中。 GitHub 令牌：在 https://github.com/settings/tokens 生成具有 repo 权限范围的令牌。 OpenAI 密钥：从 https://platform.openai.com/account/api-keys 获取。

故障排除

“无法启动 GitHub MCP 服务”： 确保 GITHUB_PERSONAL_ACCESS_TOKEN 有效且具有 repo 权限范围。 检查互联网连接。

“查询 OpenAI 时出错”： 确认 OPENAI_API_KEY 正确。

Git 中的 node_modules： 确保 .gitignore 包含 node_modules/，然后运行：git rm -r --cached node_modules git commit -m "Remove node_modules"

无法识别命令： 使用准确的措辞（例如，“create new repo named my-repo”），或检查脚本的 handleGitHubOperation 函数。

贡献

复刻该存储库。 创建功能分支（git checkout -b feature/your-feature）。 提交更改（git commit -m "Add your feature"）。 将更改推送到该分支（git push origin feature/your-feature）。 发起拉取请求。

许可证 MIT 许可证。详情请参阅 LICENSE。 联系 如有问题或建议，请在 GitHub 上提交 issue，或联系 [your-username]。