minhoyooDEV_confluence-mcp-server

minhoyooDEV_confluence-mcp-server

3.1
communication

If you are the rightful owner of minhoyooDEV_confluence-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Confluence MCP Server is a Model Context Protocol server system designed to access the Confluence API using a Personal Access Token, acting as an intermediary server within a VPN area.

Confluence MCP Server

Confluence API에 μ ‘κ·Όν•˜κΈ° μœ„ν•œ Model Context Protocol μ„œλ²„ μ‹œμŠ€ν…œμž…λ‹ˆλ‹€. Personal Access Token을 μ‚¬μš©ν•˜μ—¬ Confluence와 ν†΅μ‹ ν•©λ‹ˆλ‹€. VPN μ˜μ—­ λ‚΄μ—μ„œ Confluence API에 μ ‘κ·Όν•˜κΈ° μœ„ν•œ μ€‘κ°œ μ„œλ²„ 역할을 ν•©λ‹ˆλ‹€.

μ‹œμŠ€ν…œ ꡬ성

이 ν”„λ‘œμ νŠΈλŠ” 두 가지 μ„œλ²„λ‘œ κ΅¬μ„±λ˜μ–΄ μžˆμŠ΅λ‹ˆλ‹€:

  1. MCP μ„œλ²„ (server.ts): Confluence API와 ν†΅μ‹ ν•˜μ—¬ 데이터λ₯Ό μ²˜λ¦¬ν•˜λŠ” μ£Ό μ„œλ²„μž…λ‹ˆλ‹€.

    • κΈ°λ³Έ 포트: 3000
    • RESTful API 제곡
    • MCP ν”„λ‘œν† μ½œ 처리

  2. ν”„λ‘μ‹œ μ„œλ²„ (proxyServer.ts): MCP ν΄λΌμ΄μ–ΈνŠΈμ™€ MCP μ„œλ²„ μ‚¬μ΄μ˜ ν”„λ‘μ‹œ 역할을 ν•©λ‹ˆλ‹€.

    • κΈ°λ³Έ 포트: 3001
    • MCP ν΄λΌμ΄μ–ΈνŠΈλ‘œλΆ€ν„° μš”μ²­μ„ λ°›μ•„ μ£Ό μ„œλ²„λ‘œ 전달

이 κ΅¬μ‘°λŠ” VPN μ˜μ—­ 문제λ₯Ό ν•΄κ²°ν•˜κΈ° μœ„ν•΄ μ„€κ³„λ˜μ—ˆμŠ΅λ‹ˆλ‹€. MCP μ„œλ²„λŠ” VPN λ‚΄λΆ€μ—μ„œ μ‹€ν–‰λ˜μ–΄ Confluence API에 μ ‘κ·Όν•˜κ³ , ν”„λ‘μ‹œ μ„œλ²„λŠ” μ™ΈλΆ€μ—μ„œ μ ‘κ·Ό κ°€λŠ₯ν•œ ν™˜κ²½μ—μ„œ μ‹€ν–‰λ©λ‹ˆλ‹€.

κΈ°λŠ₯

  • λͺ¨λ“  Confluence 슀페이슀 λͺ©λ‘ 쑰회
  • νŠΉμ • 슀페이슀 λ‚΄μ˜ λͺ¨λ“  νŽ˜μ΄μ§€ 쑰회
  • νŽ˜μ΄μ§€ ID둜 νŠΉμ • νŽ˜μ΄μ§€ 정보 쑰회
  • μƒˆ νŽ˜μ΄μ§€ 생성
  • κΈ°μ‘΄ νŽ˜μ΄μ§€ μ—…λ°μ΄νŠΈ

μ„€μΉ˜ 및 μ„€μ •

ν•„μˆ˜ 쑰건

  • Node.js 16.x 이상
  • Bun 1.0.0 이상

μ„€μΉ˜

# μ €μž₯μ†Œ 클둠
git clone https://github.com/yourusername/confluence-mcp-server.git
cd confluence-mcp-server

# μ˜μ‘΄μ„± μ„€μΉ˜
bun install

ν™˜κ²½ λ³€μˆ˜ μ„€μ •

.env νŒŒμΌμ„ ν”„λ‘œμ νŠΈ λ£¨νŠΈμ— μƒμ„±ν•˜κ³  λ‹€μŒ λ‚΄μš©μ„ μΆ”κ°€ν•©λ‹ˆλ‹€:

PORT=3000
PROXY_PORT=3001
MCP_SERVER_URL=http://localhost:3000
CONFLUENCE_BASE_URL=https://wiki.musinsa.com
PERSONAL_ACCESS_TOKEN=your_personal_access_token
NODE_ENV=development

μ‹€ν–‰

개발 ν™˜κ²½

# MCP μ„œλ²„ μ‹€ν–‰ (Confluence API와 톡신)
bun run dev

# ν”„λ‘μ‹œ μ„œλ²„ μ‹€ν–‰ (MCP ν΄λΌμ΄μ–ΈνŠΈμ™€ 톡신)
bun run dev:proxy

# MCP μ„œλ²„ Stdio λͺ¨λ“œ μ‹€ν–‰ (선택 사항)
bun run dev:stdio

ν”„λ‘œλ•μ…˜ ν™˜κ²½

# λΉŒλ“œ
bun run build

# MCP μ„œλ²„ μ‹€ν–‰
bun run serve

# ν”„λ‘μ‹œ μ„œλ²„ μ‹€ν–‰
bun run serve:proxy

μ—”λ“œν¬μΈνŠΈ

MCP μ„œλ²„ μ—”λ“œν¬μΈνŠΈ (κΈ°λ³Έ 포트: 3000)

  • POST /mcp - MCP μš”μ²­μ„ μ²˜λ¦¬ν•˜λŠ” 메인 μ—”λ“œν¬μΈνŠΈ
  • GET /mcp/tools - μ‚¬μš© κ°€λŠ₯ν•œ 도ꡬ λͺ©λ‘ 쑰회
  • GET /api/spaces - λͺ¨λ“  슀페이슀 λͺ©λ‘ 쑰회
  • GET /api/spaces/:spaceKey/pages - νŠΉμ • 슀페이슀의 νŽ˜μ΄μ§€ λͺ©λ‘ 쑰회
  • GET /api/pages/:pageId - νŠΉμ • νŽ˜μ΄μ§€ 정보 쑰회
  • POST /api/pages - μƒˆ νŽ˜μ΄μ§€ 생성
  • PUT /api/pages/:pageId - νŽ˜μ΄μ§€ μ—…λ°μ΄νŠΈ
  • GET /health - μ„œλ²„ μƒνƒœ 확인

ν”„λ‘μ‹œ μ„œλ²„ μ—”λ“œν¬μΈνŠΈ (κΈ°λ³Έ 포트: 3001)

  • POST /mcp - MCP ν΄λΌμ΄μ–ΈνŠΈ μš”μ²­μ„ λ°›μ•„ MCP μ„œλ²„λ‘œ 전달
  • GET /tools - μ‚¬μš© κ°€λŠ₯ν•œ 도ꡬ λͺ©λ‘ 쑰회
  • GET /health - ν”„λ‘μ‹œ μ„œλ²„ μƒνƒœ 확인

문제 ν•΄κ²°

VPN μ˜μ—­ 문제 ν•΄κ²°

이 ν”„λ‘œμ νŠΈλŠ” VPN μ˜μ—­ 문제λ₯Ό ν•΄κ²°ν•˜κΈ° μœ„ν•΄ 두 μ„œλ²„λ‘œ λΆ„λ¦¬λ˜μ—ˆμŠ΅λ‹ˆλ‹€:

  1. MCP μ„œλ²„λŠ” VPN λ‚΄λΆ€μ—μ„œ μ‹€ν–‰ν•˜μ—¬ Confluence API에 직접 μ ‘κ·Όν•©λ‹ˆλ‹€.
  2. ν”„λ‘μ‹œ μ„œλ²„λŠ” μ™ΈλΆ€μ—μ„œ μ ‘κ·Ό κ°€λŠ₯ν•œ ν™˜κ²½μ—μ„œ μ‹€ν–‰ν•˜μ—¬ MCP ν΄λΌμ΄μ–ΈνŠΈμ˜ μš”μ²­μ„ λ°›μŠ΅λ‹ˆλ‹€.

이 ꡬ성은 MCP ν΄λΌμ΄μ–ΈνŠΈκ°€ 직접 Confluence API에 μ ‘κ·Όν•  수 μ—†λŠ” μƒν™©μ—μ„œ μ€‘κ°œ 역할을 ν•©λ‹ˆλ‹€.

"Error fetching spaces: Unable to connect" 였λ₯˜

이 였λ₯˜λŠ” λ‹€μŒκ³Ό 같은 문제둜 λ°œμƒν•  수 μžˆμŠ΅λ‹ˆλ‹€:

  1. HTTPS μΈμ¦μ„œ 문제: 개발 ν™˜κ²½μ—μ„œλŠ” SSL μΈμ¦μ„œ 검증이 λΉ„ν™œμ„±ν™”λ˜μ–΄ μžˆμ§€λ§Œ, ν”„λ‘œλ•μ…˜ ν™˜κ²½μ—μ„œλŠ” μ˜¬λ°”λ₯Έ μΈμ¦μ„œ 섀정이 ν•„μš”ν•©λ‹ˆλ‹€.

  2. λ„€νŠΈμ›Œν¬ μ—°κ²° 문제: λ°©ν™”λ²½μ΄λ‚˜ ν”„λ‘μ‹œ μ„€μ •μœΌλ‘œ 인해 Confluence μ„œλ²„μ— μ ‘κ·Όν•  수 μ—†λŠ” κ²½μš°μž…λ‹ˆλ‹€.

  3. Personal Access Token 문제: 토큰이 λ§Œλ£Œλ˜μ—ˆκ±°λ‚˜ 잘λͺ»λœ ν˜•μ‹μΌ 수 μžˆμŠ΅λ‹ˆλ‹€.

ν•΄κ²° 방법

  1. .env 파일의 CONFLUENCE_BASE_URL이 μ˜¬λ°”λ₯Έμ§€ ν™•μΈν•©λ‹ˆλ‹€.
  2. Personal Access Token이 μœ νš¨ν•œμ§€ ν™•μΈν•©λ‹ˆλ‹€.
  3. λ°©ν™”λ²½ 섀정을 ν™•μΈν•˜μ—¬ Confluence μ„œλ²„μ— μ ‘κ·Όν•  수 μžˆλŠ”μ§€ ν™•μΈν•©λ‹ˆλ‹€.
  4. λ„€νŠΈμ›Œν¬ κ΄€λ¦¬μžμ—κ²Œ λ¬Έμ˜ν•˜μ—¬ μ ‘κ·Ό κΆŒν•œμ„ ν™•μΈν•©λ‹ˆλ‹€.
  5. MCP μ„œλ²„μ™€ ν”„λ‘μ‹œ μ„œλ²„ κ°„μ˜ 연결이 μ˜¬λ°”λ₯΄κ²Œ μ„€μ •λ˜μ—ˆλŠ”μ§€ ν™•μΈν•©λ‹ˆλ‹€ (MCP_SERVER_URL μ„€μ •).

ν…ŒμŠ€νŠΈ

# λͺ¨λ“  ν…ŒμŠ€νŠΈ μ‹€ν–‰
bun test

# νŠΉμ • ν…ŒμŠ€νŠΈ μ‹€ν–‰
bun test src/test/getSpaces.test.ts

배포 ꡬ성

ꢌμž₯ 배포 ꡬ성

ν”„λ‘œλ•μ…˜ ν™˜κ²½μ—μ„œλŠ” λ‹€μŒκ³Ό 같은 배포 ꡬ성을 ꢌμž₯ν•©λ‹ˆλ‹€:

  1. MCP μ„œλ²„: VPN λ‚΄λΆ€ λ˜λŠ” Confluence μ„œλ²„μ— μ ‘κ·Όν•  수 μžˆλŠ” λ„€νŠΈμ›Œν¬μ— 배포
  2. ν”„λ‘μ‹œ μ„œλ²„: MCP ν΄λΌμ΄μ–ΈνŠΈκ°€ μ ‘κ·Όν•  수 μžˆλŠ” λ„€νŠΈμ›Œν¬μ— 배포

λ³΄μ•ˆ 고렀사항

  • ν”„λ‘μ‹œ μ„œλ²„μ™€ MCP μ„œλ²„ κ°„μ˜ 톡신은 HTTPSλ₯Ό μ‚¬μš©ν•˜μ—¬ μ•”ν˜Έν™”ν•˜λŠ” 것을 ꢌμž₯ν•©λ‹ˆλ‹€.
  • Personal Access Token은 μ•ˆμ „ν•˜κ²Œ κ΄€λ¦¬ν•˜κ³ , ν•„μš”μ— 따라 μ •κΈ°μ μœΌλ‘œ κ°±μ‹ ν•˜μ„Έμš”.
  • ν”„λ‘œλ•μ…˜ ν™˜κ²½μ—μ„œλŠ” μ μ ˆν•œ 인증 λ©”μ»€λ‹ˆμ¦˜μ„ μΆ”κ°€ν•˜μ—¬ ν”„λ‘μ‹œ μ„œλ²„μ— λŒ€ν•œ 무단 접근을 λ°©μ§€ν•˜μ„Έμš”.

λΌμ΄μ„ΌμŠ€

MIT

Related MCP Servers

View all communication servers β†’
Time

Time

4.3

by modelcontextprotocol

A Model Context Protocol server that provides time and timezone conversion capabilities.

communication
discordmcp

discordmcp

4.3

by v-3

A Model Context Protocol (MCP) server that enables LLMs to interact with Discord channels, allowing them to send and read messages through Discord's API.

communication
mcp-discord

mcp-discord

4.2

by hanweg

A Model Context Protocol (MCP) server that provides Discord integration capabilities to MCP clients like Claude Desktop.

communication
algorand-mcp

algorand-mcp

4.1

by GoPlausible

This is a Model Context Protocol (MCP) implementation for Algorand blockchain interactions, providing a server package for blockchain interactions and a client package for wallet management and transaction signing.

communication
twilio_manager_mcp

twilio_manager_mcp

3.8

by errajibadr

Twilio Manager MCP is a Model Context Protocol implementation for managing Twilio resources, providing tools for managing Twilio subaccounts, phone numbers, and regulatory bundles through a standardized MCP interface.

communication
apple-mcp

apple-mcp

3.8

by supermemoryai

This is a collection of Apple-native tools for the Model Context Protocol (MCP) that integrates with various Apple applications to automate tasks and manage communications.

os_automation
whatsapp-mcp

whatsapp-mcp

3.8

by lharries

This is a Model Context Protocol (MCP) server for WhatsApp, allowing users to interact with their WhatsApp messages and contacts through an LLM like Claude.

communication
Inbox Zero AI

Inbox Zero AI

3.7

by elie222

Inbox Zero MCP Server is designed to help users manage their inbox efficiently by integrating with various desktop applications.

communication
mcp-nats

mcp-nats

3.7

by sinadarbouy

A Model Context Protocol (MCP) server for NATS messaging system integration.

communication
Gmail-MCP-Server

Gmail-MCP-Server

3.7

by GongRzhe

A Model Context Protocol (MCP) server for Gmail integration in Claude Desktop with auto authentication support. This server enables AI assistants to manage Gmail through natural language interactions.

communication
graphlit-mcp-server

graphlit-mcp-server

3.7

by graphlit

The Model Context Protocol (MCP) Server for the Graphlit Platform facilitates integration between MCP clients and the Graphlit service, enabling seamless ingestion, search, and retrieval of knowledge across various platforms.

knowledge_and_memory
twitter-mcp

twitter-mcp

3.7

by EnesCinr

This MCP server allows Clients to interact with Twitter, enabling posting tweets and searching Twitter.

communication
line-bot-mcp-server

line-bot-mcp-server

3.7

by line

LINE Bot MCP Server integrates the LINE Messaging API to connect an AI Agent to the LINE Official Account.

communication
mcp-gsuite

mcp-gsuite

3.7

by MarkusPfundstein

MCP server to interact with Google products, specifically Gmail and Calendar.

communication
linear-mcp-server

linear-mcp-server

3.7

by jerhadf

A Model Context Protocol server for the Linear API, providing integration with Linear's issue tracking system through MCP.

communication
homeassistant-mcp

homeassistant-mcp

3.7

by tevonsb

The server uses the MCP protocol to share access to a local Home Assistant instance with an LLM application.

os_automation
spotify-mcp

spotify-mcp

3.7

by varunneal

MCP project to connect Claude with Spotify using spotipy-dev's API.

entertainment_and_media
mcp-hfspace

mcp-hfspace

3.6

by evalstate

mcp-hfspace MCP Server connects to Hugging Face Spaces with minimal setup, providing Image Generation capabilities to Claude Desktop.

ai_chatbot
monday.com MCP Server

monday.com MCP Server

3.6

by mondaycom

A server implementation for the Model Context Protocol (MCP) that provides an interface to interact with Monday.com API.

communication
base-mcp

base-mcp

3.6

by base

A Model Context Protocol (MCP) server that provides onchain tools for AI applications like Claude Desktop and Cursor, allowing them to interact with the Base Network and Coinbase API.

finance
mcp-google-ads

mcp-google-ads

3.6

by cohnen

Google Ads MCP is a tool that integrates Google Ads with Claude AI, enabling users to analyze advertising data through natural language conversations.

ai_chatbot
search1api-mcp

search1api-mcp

3.6

by fatwang2

A Model Context Protocol (MCP) server that provides search and crawl functionality using Search1API.

browser_automation
slack-mcp-server

slack-mcp-server

3.6

by korotovsky

The Slack MCP Server is a Model Context Protocol server designed for Slack Workspaces, supporting Stdio and SSE transports without requiring permissions or bot creation.

communication
mcp-server

mcp-server

3.6

by PortSwigger

Integrate Burp Suite with AI Clients using the Model Context Protocol (MCP).

communication
meta-ads-mcp

meta-ads-mcp

3.6

by pipeboard-co

Meta Ads MCP is a Model Context Protocol server designed to interact with the Meta Ads API, enabling AI models to manage and analyze advertising campaigns on Meta platforms like Facebook and Instagram.

communication
mac_messages_mcp

mac_messages_mcp

3.6

by carterlasalle

Mac Messages MCP is a Python bridge for interacting with the macOS Messages app using the Multiple Context Protocol (MCP).

communication
confluence-mcp-server

confluence-mcp-server

3.6

by pawankumar94

A Model Context Protocol (MCP) server implementation for Atlassian Confluence, enabling AI agents to interact with Confluence content.

cloud_platforms