klink (Irvingdinh)

铃声

一个模块化的MCP（模型上下文协议）服务器，将您的生产力工具连接到AI助手。无缝集成啊哈！、Confluence、Jira、GitHub、Slack、Telegram、Quip、Pocketbase和Replicate到Claude、Cursor和其他MCP兼容客户端。

特性

快速开始

直接通过npx使用klinklang-无需安装：

npx klinklang@latest

或全局安装：

npm install -g klinklang
klinklang

配置

环境变量

啊哈！

汇流

Jira

GitHub

Slack

电报

妙语

口袋底座

复制

模块选择

使用CLI选项或环境变量控制加载哪些模块：

# CLI examples
npx klinklang@latest -- --include jira,github
npx klinklang@latest -- --exclude quip,slack

# Environment variable examples
KLINKLANG_INCLUDE=jira,github npx klinklang@latest
KLINKLANG_EXCLUDE=quip,slack npx klinklang@latest

优先： 如果同时设置了环境变量和CLI选项，则环境变量将覆盖这两个选项。 注： include 和 exclude 相互排斥（无论来源如何）。

可用工具

啊哈！

汇流

Jira

GitHub

Slack

电报

妙语

口袋底座

复制

客户端设置

克劳德桌面

添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "klinklang": {
      "command": "npx",
      "args": ["-y", "klinklang@latest"],
      "env": {
        "AHA_HOST": "https://your-company.aha.io",
        "AHA_API_TOKEN": "your-api-key",
        "CONFLUENCE_HOST": "https://wiki.example.com",
        "CONFLUENCE_API_TOKEN": "your-pat",
        "JIRA_HOST": "https://your-org.atlassian.net",
        "JIRA_EMAIL_ADDRESS": "you@company.com",
        "JIRA_API_TOKEN": "your-token",
        "GITHUB_HOST": "https://api.github.com",
        "GITHUB_API_TOKEN": "ghp_your-token",
        "SLACK_API_TOKEN": "xoxb-your-token",
        "TELEGRAM_BOT_TOKEN": "your-bot-token",
        "QUIP_API_TOKEN": "your-token",
        "POCKETBASE_HOST": "https://pb.example.com",
        "POCKETBASE_ADMIN_EMAIL": "admin@example.com",
        "POCKETBASE_ADMIN_PASSWORD": "your-password",
        "REPLICATE_API_TOKEN": "r8_your-token"
      }
    }
  }
}

光标

添加到光标MCP设置(.cursor/mcp.json 在您的项目或全局配置中）：

{
  "mcpServers": {
    "klinklang": {
      "command": "npx",
      "args": ["-y", "klinklang@latest", "--", "--exclude", "quip"],
      "env": {
        "AHA_HOST": "https://your-company.aha.io",
        "AHA_API_TOKEN": "your-api-key",
        "CONFLUENCE_HOST": "https://wiki.example.com",
        "CONFLUENCE_API_TOKEN": "your-pat",
        "JIRA_HOST": "https://your-org.atlassian.net",
        "JIRA_EMAIL_ADDRESS": "you@company.com",
        "JIRA_API_TOKEN": "your-token",
        "GITHUB_HOST": "https://api.github.com",
        "GITHUB_API_TOKEN": "ghp_your-token",
        "SLACK_API_TOKEN": "xoxb-your-token",
        "TELEGRAM_BOT_TOKEN": "your-bot-token",
        "POCKETBASE_HOST": "https://pb.example.com",
        "POCKETBASE_ADMIN_EMAIL": "admin@example.com",
        "POCKETBASE_ADMIN_PASSWORD": "your-password",
        "REPLICATE_API_TOKEN": "r8_your-token"
      }
    }
  }
}

OpenAI Codex命令行界面

codex mcp add klinklang -- npx -y klinklang@latest

建筑

src/
├── index.ts                    # Entry point, module registration
├── core/
│   ├── service/
│   │   ├── env.service.ts      # Environment variable handling
│   │   ├── file.service.ts     # Temporary file output
│   │   └── module-config.service.ts  # --include/--exclude parsing
│   └── utils/
│       ├── http.utils.ts       # HTTP error formatting
│       └── tool.utils.ts       # Handler wrappers (withErrorHandling, etc.)
├── aha/
│   ├── services/external/      # Aha! API client
│   └── tools/                  # aha_* tool definitions
├── confluence/
│   ├── services/external/      # Confluence REST API client
│   └── tools/                  # confluence_* tool definitions
├── jira/
│   ├── services/external/      # Jira API client
│   └── tools/                  # jira_* tool definitions
├── github/
│   ├── services/external/      # GitHub API client
│   └── tools/                  # github_* tool definitions
├── slack/
│   ├── services/external/      # Slack Web API client
│   └── tools/                  # slack_* tool definitions
├── telegram/
│   ├── services/external/      # Telegram API client
│   └── tools/                  # telegram_* tool definitions
├── quip/
│   ├── services/external/      # Quip API client
│   └── tools/                  # quip_* tool definitions
├── pocketbase/
│   ├── services/external/      # Pocketbase API client
│   └── tools/                  # pocketbase_* tool definitions
└── replicate/
    ├── services/external/      # Replicate API client
    └── tools/                  # replicate_* tool definitions

发展

设置

npm install

测试工具

使用JSON-RPC消息通过stdio测试MCP工具：

cat << 'EOF' | node dist/index.js
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"stdio-test","version":"0.0.0"}}}
{"jsonrpc":"2.0","method":"notifications/initialized"}
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"jira_get_issue","arguments":{"issueIdOrKey":"PROJ-123"}}}
EOF

建筑

npm run build       # Build with tsup

指南

• 书写工具说明： 看 docs/guidelines/mcp-tool-description.md编写指南
• 实现工具处理程序： 看 docs/guidelines/mcp-tool-handler.md编写指南

代码检查

npm run lint        # Check for issues
npm run lint:fix    # Auto-fix issues

许可证

麻省理工学院