mcp-server-sample

CheolMinBae/mcp-server-sample

3.1

If you are the rightful owner of mcp-server-sample 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.

This project is an MCP (Model Context Protocol) server based on the 2025 tax law amendment PDF document, utilizing Vector DB and LangChain for document content search and information retrieval.

2025๋…„ ์„ธ๋ฒ• ๊ฐœ์ •์•ˆ MCP ์„œ๋ฒ„

์ด ํ”„๋กœ์ ํŠธ๋Š” 2025๋…„ ์„ธ๋ฒ• ๊ฐœ์ •์•ˆ PDF ๋ฌธ์„œ๋ฅผ ๊ธฐ๋ฐ˜์œผ๋กœ ํ•œ MCP(Model Context Protocol) ์„œ๋ฒ„์ž…๋‹ˆ๋‹ค. Vector DB์™€ LangChain์„ ํ™œ์šฉํ•˜์—ฌ ๋ฌธ์„œ ๋‚ด์šฉ์„ ๊ฒ€์ƒ‰ํ•˜๊ณ  ๊ด€๋ จ ์ •๋ณด๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

๊ธฐ๋Šฅ

  • PDF ๋ฌธ์„œ ํŒŒ์‹ฑ ๋ฐ ์ฒญํฌ ๋ถ„ํ• 
  • ChromaDB๋ฅผ ์ด์šฉํ•œ ๋ฒกํ„ฐ ์ €์žฅ ๋ฐ ๊ฒ€์ƒ‰
  • MCP ํ”„๋กœํ† ์ฝœ์„ ํ†ตํ•œ ๋ฌธ์„œ ๊ฒ€์ƒ‰ API
  • ์ž์—ฐ์–ด ์ฟผ๋ฆฌ๋ฅผ ํ†ตํ•œ ์„ธ๋ฒ• ์ •๋ณด ๊ฒ€์ƒ‰

์„ค์น˜ ๋ฐ ์‹คํ–‰

1. ์˜์กด์„ฑ ์„ค์น˜

pip install -r requirements.txt

2. ChromaDB ์‹คํ–‰

docker-compose up -d

3. ๋ฌธ์„œ ์ธ๋ฑ์‹ฑ

python index_document.py

4. MCP ์„œ๋ฒ„ ์‹คํ–‰

python mcp_server.py

MCP ์„œ๋ฒ„ ์„ค์ •

Clode ํด๋ผ์ด์–ธํŠธ ์„ค์ •

Clode์—์„œ MCP ์„œ๋ฒ„๋ฅผ ์ถ”๊ฐ€ํ•˜๋ ค๋ฉด:

  1. Clode ์„ค์ •์—์„œ MCP ์„œ๋ฒ„ ์ถ”๊ฐ€
  2. ์„œ๋ฒ„ ๊ฒฝ๋กœ: python /path/to/mcp_server.py
  3. ์„œ๋ฒ„ ์ด๋ฆ„: tax-document-mcp

Cursor IDE ์„ค์ •

Cursor์—์„œ MCP ์„œ๋ฒ„๋ฅผ ์ถ”๊ฐ€ํ•˜๋ ค๋ฉด:

  1. Cursor ์„ค์ • ํŒŒ์ผ์— MCP ์„œ๋ฒ„ ์ถ”๊ฐ€
  2. ์„œ๋ฒ„ ๊ฒฝ๋กœ: python /path/to/mcp_server.py
  3. ์„œ๋ฒ„ ์ด๋ฆ„: tax-document-mcp

API ์‚ฌ์šฉ๋ฒ•

MCP ์„œ๋ฒ„๋Š” ๋‹ค์Œ ๊ธฐ๋Šฅ์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค:

  • search_document: ๋ฌธ์„œ ๋‚ด์šฉ ๊ฒ€์ƒ‰
  • get_document_info: ๋ฌธ์„œ ์ •๋ณด ์กฐํšŒ
  • list_collections: ์ €์žฅ๋œ ์ปฌ๋ ‰์…˜ ๋ชฉ๋ก ์กฐํšŒ

ํ™˜๊ฒฝ ๋ณ€์ˆ˜

  • CHROMA_HOST: ChromaDB ํ˜ธ์ŠคํŠธ (๊ธฐ๋ณธ๊ฐ’: localhost)
  • CHROMA_PORT: ChromaDB ํฌํŠธ (๊ธฐ๋ณธ๊ฐ’: 8000)
  • PDF_PATH: PDF ํŒŒ์ผ ๊ฒฝ๋กœ (๊ธฐ๋ณธ๊ฐ’: 2025_tax.pdf)