模型上下文协议服务器

提供Confluence和GitHub的模型上下文协议服务器,支持搜索、获取内容和API操作。

  • by fvpmtinoco
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 fvpmtinoco/mcp-servers

使用说明

MCP服务器

此存储库包含模型上下文协议(MCP)服务器:a 汇流 MCP服务器和 GitHub MCP服务器。

项目结构

  • confluence_mcp/
    • package.json Confluence 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 详细信息)。