使用说明
MCP服务器
此存储库包含模型上下文协议(MCP)服务器:a 汇流 MCP服务器和 GitHub MCP服务器。
项目结构
confluence_mcp/package.jsonConfluence MCP服务器的节点包定义package-lock.json–锁定依赖关系树以进行可重复安装index.js–MCP服务器实现,公开Confluence搜索功能
github_mcp/package.json–GitHub MCP服务器的节点包定义package-lock.json–锁定依赖关系树以进行可重复安装index.js–公开GitHub API操作(转发、文件、分支、PR)的MCP服务器实现
README.md–此文件.gitignore–标准Git忽略规则
汇流MCP服务器
Confluence MCP服务器公开了一个工具, search_confluence,它允许兼容的MCP客户端(如AI助手)从Atlassian Confluence实例中搜索或获取内容。
特性
- 按关键字搜索Confluence页面
- 按页面ID获取特定Confluence页面
- 以结构化、JSON友好的格式返回页面内容或搜索结果
技术栈
- 运行时:Node.js(ES模块)
- MCP-SDK:
@modelcontextprotocol/sdk - HTTP客户端:
axios - 配置:
dotenv - 验证:
zod
安装与配置
cd confluence_mcp
npm install
设置这些环境变量(例如在 .env 文件):
CONFLUENCE_BASE_URL–Confluence网站的基本URL(例如。https://your-domain.atlassian.net)CONFLUENCE_EMAIL–您Atlassian帐户的电子邮件CONFLUENCE_API_TOKEN–Atlassian API代币
工具: search_confluence
- 输入:
pageId(可选),query(可选),limit(可选,默认值10)。提供其中之一pageId或query. - 行为:按ID获取页面或按关键字搜索,并返回内容或结果列表(ID、标题、url、摘录)。
GitHub MCP服务器
GitHub MCP服务器公开了使用GitHub API列出回购、浏览回购树、读写文件、创建分支和打开拉取请求的工具。
特性
- 列出经过身份验证的用户或组织的存储库
- 获取存储库的文件/文件夹结构
- 从存储库获取文件内容
- 在分支上创建或更新文件
- 从现有分支创建新分支
- 创建pull请求
技术栈
- 运行时:Node.js(ES模块)
- MCP-SDK:
@modelcontextprotocol/sdk - HTTP客户端:
axios - 配置:
dotenv - 验证:
zod
安装与配置
cd github_mcp
npm install
设置此环境变量(例如在 .env 文件):
GITHUB_TOKEN–具有适当仓库权限的GitHub个人访问令牌(读取列表/树/文件;写入创建/更新文件、创建分支、创建PR)
工具
| 工具 | 说明 |
|---|---|
list_repos |
列出经过身份验证的用户或组织的存储库。输入: org (可选), limit (可选,默认值为30)。 |
get_repo_tree |
获取存储库的文件/文件夹结构。输入: owner, repo, branch (可选,默认为main)。 |
get_file |
获取存储库中文件的内容。输入: owner, repo, path, branch (可选)。 |
create_or_update_file |
在分支上创建或更新文件。输入: owner, repo, path, content, message, branch. |
create_branch |
从基础分支创建新分支。输入: owner, repo, branch, from_branch (可选)。 |
create_pull_request |
将PR从分支打开到基础分支。输入: owner, repo, title, body, head, base (可选)。 |
运行服务器
每台服务器使用 StdioServerTransport 并且通常由MCP兼容主机(例如IDE或AI助手)运行。对于最小直接运行:
# Confluence
cd confluence_mcp && node index.js
# GitHub
cd github_mcp && node index.js
有关如何注册和运行这些服务器,请参阅MCP主机的文档。
贡献
- 分叉或克隆此存储库。
- 创建特征分支(例如。
feat/new-server或chore/maintenance-task). - 进行更改,并在适当的情况下添加测试或示例。
- 打开一个pull请求
main并对变化进行了清晰的描述。
许可证
此项目根据ISC许可证获得许可(请参阅每台服务器的 package.json 详细信息)。