Skip to main content
Glama
enesjakozh
Shawyeok

mcp-dingding-bot

by Shawyeok
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

MCP 딩딩 봇

DingDing Bot API를 위한 MCP 서버로, DingDing/Dingtalk 메시지 알림 및 상호작용을 지원합니다.

특징

  • 메시지 알림 : 다양한 유형의 딩딩 메시지(텍스트/마크다운)를 전송합니다.

Related MCP server: dingtalk-mcp

도구

  1. send_text_message

    • 딩딩 그룹에 일반 텍스트 메시지 보내기

    • 입력:

      • text (문자열): 텍스트 콘텐츠

      • atAll (선택적 부울): 모든 멤버에게 @를 적용할지 여부

  2. send_markdown_message

    • dingding 그룹에 마크다운 형식의 메시지 보내기

    • 입력:

      • title (문자열): 메시지 제목

      • text (문자열): 마크다운 콘텐츠

      • atAll (선택적 부울): 모든 멤버에게 @를 적용할지 여부

설정

딩딩 봇 토큰

  1. DingDing 그룹 채팅 봇 만들기:

    • 그룹 설정 > 그룹 봇 관리로 이동하세요.

    • 사용자 정의 봇 만들기

    • 웹훅 URL과 비밀번호를 저장합니다.

Claude Desktop과 함께 사용

claude_desktop_config.json 에 다음을 추가하세요.

도커

지엑스피1

엔피엑스

{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-dingding-bot"
      ],
      "env": {
        "DINGTALK_BOT_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>",
        "DINGTALK_BOT_SECRET": "<YOUR_SECRET>" // Optional, for robots with signature verification enabled
      }
    }
  }
}

짓다

Docker 빌드:

docker build -t shawyeok/mcp-dingding-bot .

환경 변수

  • DINGTALK_BOT_ACCESS_TOKEN : dingding 그룹 로봇 액세스 토큰(필수)

  • DINGTALK_BOT_SECRET : 딩딩 그룹 로봇 서명 비밀번호(선택 사항)

참고문헌

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 약관에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.

Available Tools

2 tools
send_markdown_messageC

Send a markdown message

ParametersJSON Schema
NameRequiredDescriptionDefault
titleYesThe title of the message
textYesThe text content to send
atMobilesNoThe mobile numbers of users to @mention (ping) individually in the group chat
atAllNoWhether to @all the users in the group

TDQS

C2/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. 'Send a markdown message' only indicates a sending action without revealing any behavioral traits such as permissions required, rate limits, whether it's a read-only or destructive operation, or what happens upon success/failure. This leaves critical behavioral aspects undocumented.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise with just three words, making it front-loaded and free of unnecessary information. Every word directly relates to the tool's function, though this brevity comes at the cost of completeness. For conciseness alone, it scores perfectly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has no annotations, no output schema, and a sibling tool, the description is completely inadequate. It fails to explain what the tool does beyond its name, when to use it, behavioral aspects, or how it differs from 'send_text_message'. For a messaging tool with potential side effects and alternatives, this minimal description provides insufficient context for effective use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage, with all four parameters clearly documented in the schema itself. The description adds no additional meaning beyond what the schema provides, such as explaining parameter interactions or usage examples. With high schema coverage, the baseline score of 3 is appropriate as the schema handles parameter documentation adequately.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Send a markdown message' is a tautology that essentially restates the tool name 'send_markdown_message'. It doesn't specify what resource is being acted upon (e.g., a chat channel, notification system, or messaging platform) or distinguish this tool from its sibling 'send_text_message'. The purpose is vague and lacks specificity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no guidance on when to use this tool versus alternatives like 'send_text_message'. The description provides no context about appropriate use cases, prerequisites, or exclusions. Without any usage guidelines, agents cannot make informed decisions between similar tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

send_text_messageC

Send a plain text message

ParametersJSON Schema
NameRequiredDescriptionDefault
textYesThe text content to send
atMobilesNoThe mobile numbers of users to @mention (ping) individually in the group chat
atAllNoWhether to @all the users in the group

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure but only states the basic action. It fails to mention critical aspects like required permissions, rate limits, side effects (e.g., message delivery confirmation), or error handling, which are essential for a messaging tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence with zero wasted words. It is appropriately sized and front-loaded, clearly stating the core purpose without unnecessary elaboration.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of a messaging tool with no annotations or output schema, the description is insufficient. It lacks details on behavioral traits, response format, error conditions, and sibling differentiation, leaving significant gaps for agent understanding.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema fully documents all parameters. The description adds no additional meaning beyond implying text content is sent, which the schema already covers. This meets the baseline for high schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Send') and resource ('a plain text message'), making the purpose immediately understandable. However, it doesn't differentiate from its sibling 'send_markdown_message' beyond the format type, missing explicit comparison that would warrant a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus its sibling 'send_markdown_message' or any alternatives. The description lacks context about appropriate use cases, prerequisites, or exclusions, leaving the agent without usage direction.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 2 tool updatesv1.0.0
    • First observedsend_markdown_message
    • First observedsend_text_message
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

C2.6/5.0

Scored across 2 tools

Disambiguation4/5

The two tools have clearly distinct purposes: one sends markdown-formatted messages, and the other sends plain text messages. While both involve sending messages, the format distinction is explicit and unlikely to cause confusion, though they could be seen as overlapping in the broader 'send message' function.

Naming Consistency5/5

Both tool names follow a consistent verb_noun pattern with 'send_' prefix and descriptive suffixes ('markdown_message', 'text_message'). The naming is predictable and adheres to a clear convention throughout the set.

Tool Count2/5

With only 2 tools, the server feels thin for a bot that might handle more messaging operations (e.g., sending images, files, or managing conversations). This minimal set limits functionality and suggests an incomplete surface for a typical bot domain.

Completeness2/5

The tool set is severely incomplete for a Dingding bot domain. It only covers sending two message types, missing essential operations like receiving messages, managing users or groups, handling events, or supporting other media formats, which will likely cause agent failures in broader use cases.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

Appeared in Searches