mcpField
C
codehost-port

codehost-port

本地服务
github.com/CloudCorpRecords版本控制02 周前更新
代码仓库

关于 codehost-port

codehost-port 是面向 GitHub 仓库协作的 MCP 服务和命令行工具，通过 GitHub REST API 提供仓库、议题和拉取请求操作。它实现了参考 MCP 服务的核心工具子集。

主要功能

  1. 01创建仓库、分支及仓库副本
  2. 02搜索仓库和代码
  3. 03读取及更新文件
  4. 04列出、创建议题并添加评论
  5. 05列出和创建拉取请求

适用场景

  1. 01创建 GitHub 仓库或分支
  2. 02搜索仓库和代码
  3. 03更新仓库文件
  4. 04跟踪议题并参与讨论
  5. 05创建拉取请求

MCP 相关

通过 stdio 提供 MCP 服务，向 MCP 客户端开放 14 项 GitHub 仓库、代码、议题和拉取请求工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "cloudcorprecords-codehost-port": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/codehost-port"
      ]
    }
  }
}
启动命令npx -y @reneturcios/codehost-port

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@reneturcios/codehost-port0.1.0
ocighcr.io/cloudcorprecords/codehost-port:0.1.0

工具

14

收录的工具列表 · 更新于 1 周前

参数类型必填说明
namestring是新仓库的名称。
privateboolean否新仓库是否应设为私有。
autoInitboolean否是否使用 README 文件初始化新仓库。
descriptionstring否新仓库的描述。

详细介绍

codehost-port

将 GitHub 仓库、议题和拉取请求作为 MCP 工具，通过 GitHub REST API 进行交互。codehost-port 是对 GitHub 参考 MCP 服务核心功能的洁净室重建，采用新名称：工具名称和线路行为相同，代码全新编写，不复制品牌元素。

工具（核心子集，共 14 个）

create_repository、fork_repository、create_branch、 get_file_contents、create_or_update_file、push_files、 search_repositories、search_code、list_issues、get_issue、 create_issue、add_issue_comment、list_pull_requests、 create_pull_request。

完整参考功能中的拉取请求详情／审查工具、议题更新工具、用户搜索和发布工具不包含在此子集中。

设置

设置 GitHub 个人访问令牌：

export GITHUB_PERSONAL_ACCESS_TOKEN=ghp_...

也可以通过 GITHUB_API_URL 指向 GitHub Enterprise （默认值为 https://api.github.com）。如果没有令牌，每次工具调用都会失败，并提示缺少的变量名称。

CLI

npx @reneturcios/codehost-port create_issue '{"owner":"octo","repo":"demo","title":"Bug"}'
npx @reneturcios/codehost-port mcp        # stdio MCP server

每个工具名称都是一个子命令，接受一个 JSON 对象参数。

MCP 客户端配置

{
  "mcpServers": {
    "codehost-port": {
      "command": "npx",
      "args": ["-y", "@reneturcios/codehost-port", "mcp"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..." }
    }
  }
}

Docker

docker run -i -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/cloudcorprecords/codehost-port

开发

npm install
npm run build
npm test

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。