Arvore MCP 服务器

由 Arvore 开发的一系列 Model Context Protocol (MCP) 服务器，用于与像 Claude 这样的AI助手无缝集成。

📦 包

此单仓库包含以下 MCP 服务器：

@arvoretech/aws-secrets-manager-mcp

直接从您的AI助手管理 AWS Secrets Manager 密钥。

特性：

• 创建、读取、更新和删除密钥
• 列出账户中的所有密钥
• 描述密钥元数据

@arvoretech/datadog-mcp

查询和分析 Datadog 监控数据。

特性：

• 查询指标和时间序列数据
• 搜索日志
• 获取服务地图和APM数据
• 列出主机和活动指标
• 搜索跟踪

@arvoretech/mysql-mcp

安全地执行只读 MySQL 查询。

特性：

• 执行 SELECT 查询
• 列出数据库中的表
• 安全的只读操作

@arvoretech/npm-registry-mcp

搜索并获取关于 npm 包的信息。

特性：

• 获取包信息和元数据
• 获取下载统计信息
• 根据查询搜索包

🚀 快速开始

安装

安装单独的包：

npm install -g @arvoretech/aws-secrets-manager-mcp
npm install -g @arvoretech/datadog-mcp
npm install -g @arvoretech/mysql-mcp
npm install -g @arvoretech/npm-registry-mcp

或使用 pnpm：

pnpm add -g @arvoretech/aws-secrets-manager-mcp

配置

添加到您的 Claude Desktop 配置文件中：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "aws-secrets-manager": {
      "command": "npx",
      "args": ["-y", "@arvoretech/aws-secrets-manager-mcp"]
    },
    "datadog": {
      "command": "npx",
      "args": ["-y", "@arvoretech/datadog-mcp"],
      "env": {
        "DATADOG_API_KEY": "your-api-key",
        "DATADOG_APP_KEY": "your-app-key",
        "DATADOG_SITE": "datadoghq.com"
      }
    },
    "mysql": {
      "command": "npx",
      "args": ["-y", "@arvoretech/mysql-mcp"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "readonly_user",
        "MYSQL_PASSWORD": "password",
        "MYSQL_DATABASE": "your_database",
        "MYSQL_PORT": "3306"
      }
    },
    "npm-registry": {
      "command": "npx",
      "args": ["-y", "@arvoretech/npm-registry-mcp"]
    }
  }
}

注意： 这些包已发布到公共 npm 注册表，并且可以直接使用 npx 而无需额外配置。

🛠️ 开发

先决条件

• Node.js >= 20
• pnpm >= 9

设置

git clone https://github.com/arvoreeducacao/arvore-mcp-servers.git
cd mcp-servers
pnpm install

构建所有包

pnpm build

运行测试

pnpm test

运行带有覆盖率的测试

pnpm test:cov

代码检查

pnpm lint

开发模式

在开发模式下运行特定包：

cd packages/aws-secrets-manager
pnpm dev

📝 添加新包

1. 在 packages/ 中创建一个新目录
2. 遵循现有包的结构
3. 更新根目录下的 README.md
4. 添加包特定的文档

🚢 发布

自动发布

此单仓库使用 GitHub Actions 自动发布到 npm。在以下情况下会自动发布：

1. 推送到主分支

当代码合并到主分支时（CI通过后），所有包都会自动发布。

2. 手动工作流调度

您可以手动触发特定包的发布：

• 前往 GitHub Actions
• 选择 "Publish Packages" 工作流
• 点击 "Run workflow"
• 指定包名（例如 @arvoretech/aws-secrets-manager-mcp）
• 选择版本提升类型（major，minor 或 patch）

设置要求

要启用自动发布，请向您的 GitHub 仓库添加这些秘密：

1. NPM_TOKEN：发布到 npm 所需

   • 在 https://www.npmjs.com/settings/tokens 创建一个令牌
   • 选择 "Automation" 令牌类型
   • 在 GitHub 设置 > 秘密和变量 > 动作中添加为仓库秘密

2. CODECOV_TOKEN（可选）：用于覆盖率报告

   • 从 https://codecov.io 获取
   • 添加为仓库秘密

手动发布

如果需要，可以手动发布（需要身份验证）：

# 发布所有包
pnpm -r publish

# 发布特定包
cd packages/aws-secrets-manager
npm publish

版本管理

要提升版本：

# 在特定包目录中
cd packages/aws-secrets-manager
pnpm version patch  # 或 minor, major

🤝 贡献

欢迎贡献！请在提交 PR 之前阅读我们的贡献指南。

📄 许可证

MIT 许可证 - 详情见 LICENSE 文件。

🔗 链接

• Model Context Protocol 文档
• Anthropic Claude
• Arvore Education

📞 支持

对于问题和疑问，请在 GitHub 上打开一个 issue。

---

由 Arvore Education 制作 ❤️