mcpField
C
codehost-remote

codehost-remote

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

关于 codehost-remote

codehost-remote 是一个 CLI 和 MCP 服务，将一组固定的 GitHub 仓库、议题及拉取请求工具转发到 GitHub 托管的 MCP 端点。它适用于无需本地 REST 客户端即可执行这些 GitHub 操作的用户。

主要功能

  1. 01仓库与分支操作
  2. 02文件内容与更新操作
  3. 03仓库和代码搜索
  4. 04议题与拉取请求操作
  5. 05转发 JSON-RPC 调用及 SSE 响应

适用场景

  1. 01搜索 GitHub 仓库或代码
  2. 02创建和更新仓库文件
  3. 03查看和管理议题
  4. 04创建拉取请求

MCP 相关

通过 MCP 服务提供 14 个 GitHub 工具，并将调用转发到 GitHub 托管的远程 MCP 端点。调用时使用 GitHub 个人访问令牌。

配置

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

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

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

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

工具

14

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

参数类型必填说明
namestring是新仓库的名称。
privateboolean否新仓库是否为私有（true）或公开（false）。
autoInitboolean否是否使用 README 文件初始化新仓库。
descriptionstring否新仓库的简短描述。

详细介绍

codehost-remote

codehost-remote 提供你熟悉的 GitHub 工具界面——仓库、 分支、文件、搜索、议题和拉取请求——无需本地 REST 客户端。每次调用都会作为 JSON-RPC tools/call 转发到 GitHub 托管的远程 MCP 端点 https://api.githubcopilot.com/mcp/，你收到的 就是托管服务的响应，无论是纯 JSON 还是流式 SSE 响应。

因此它是轻量级的选择：无需在本地跟踪 GitHub API 版本，托管服务会处理这些工作。代价是你需要依赖托管端点的可用性和行为。

此处仅开放核心子集：14 个工具。托管端点实际上提供规模大得多、动态变化的工具集（40+ 个工具）；此软件包有意固定为 repos / issues / pull-requests 核心集合，绝不声称涵盖托管端点的全部工具。

设置 GITHUB_PERSONAL_ACCESS_TOKEN；该值会作为 Bearer token 发送。 GITHUB_REMOTE_MCP_URL 可覆盖端点（便于测试）。

安装

npx @reneturcios/codehost-remote get_issue '{"owner":"octocat","repo":"hello-world","issue_number":1}'
docker run -i -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/cloudcorprecords/codehost-remote

CLI

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

codehost-remote search_repositories '{"query":"mcp language:typescript"}'
codehost-remote create_issue '{"owner":"me","repo":"proj","title":"Bug: startup crash"}'
codehost-remote --version

退出码：0 表示成功，1 表示错误，2 表示用法错误。

MCP 服务

npx -y @reneturcios/codehost-remote mcp

{
  "mcpServers": {
    "codehost-remote": {
      "command": "npx",
      "args": ["-y", "@reneturcios/codehost-remote", "mcp"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token" }
    }
  }
}
工具

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。

如果缺少 token，会报告工具错误，并指出 GITHUB_PERSONAL_ACCESS_TOKEN。

开发

npm install
npm run build
npm test

测试完全使用 fake-fetch 测试夹具运行，涵盖纯 JSON 和 SSE 上游响应体；不会使用网络。

许可证

MIT — 详见 LICENSE。

评论

支持 Markdown

第一次接触 MCP？

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

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