MCP style

首尔经济新闻风格指南 MCP 服务器

这个项目是一个工具，用于将首尔经济新闻风格指南数据提供给MCP（模型上下文协议）服务器。

安装方法

安装必需库

pip install -r requirements.txt

基本使用方法

1. 直接执行

python stylebook_mcp_fastmcp.py --stdio --data_path "기사 작성 준칙"

2. 与Sumideri的联动

1. 安装Sumideri。
2. smithery.yaml 将文件复制到Smitherly目录中。
3. 来自Sumidori @your-username/mcp_style进行分发。

3. 与Clode桌面端的连接

1. claude_desktop_config.json 将文件复制到主目录的适当位置：

- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - Windows: %APPDATA%\Claude\claude_desktop_config.json - Linux: ~/.config/Claude/claude_desktop_config.json

1. 重启 Claude 桌面程序。

测试方法

# 기본 테스트
python test_mcp.py

# 특정 데이터 경로와 함께 테스트
python test_mcp.py --data-path "기사 작성 준칙"

# 특정 검색어로 테스트
python test_mcp.py --query "문장부호"

使用MCP Inspector进行测试

npx @modelcontextprotocol/inspector python -u stylebook_mcp_fastmcp.py --stdio --data_path "."

目录结构

此MCP服务器使用以下文件结构：

.
├── smithery.yaml                # 스미더리 설정 파일
├── stylebook_mcp_fastmcp.py     # MCP 서버 메인 스크립트
├── claude_desktop_config.json   # 클로드 데스크탑 설정 파일
├── test_mcp.py                  # 테스트 스크립트
├── requirements.txt             # 필수 라이브러리 목록
└── README.md                    # 이 문서

样式手册数据结构

样式表数据应位于以下目录中（脚本通常会自动搜索）：

.
├── 기사 작성 준칙/
├── 기사작성 요령/
├── 자주 틀리는 말/
├── 제목과 레이아웃_제목달기/
├── 제목과 레이아웃_레이아웃 요령/
└── 뉴스가치 판단/

每个目录中都有 .json 必须有文件，元数据是 metadata.json 或者 _meta.json 必须放在文件里。

工具列表

MCP服务器提供以下工具：

1. get_metadata - 风格指南元数据查询
2. get_categories - 查看样式手册类别列表
3. get_rule - 通过特定规则ID查询样式手册规则
4. search - 以关键词搜索样式指南
5. claude_search - 使用 Claude AI 进行风格指南搜索
6. download_json - 下载样式表JSON文件

环境变量

• PYTHONUNBUFFERED始终设置为1以禁用缓冲
• PYTHONIOENCODING根据上面的信息，执行如下指令： utf-8设置为韩文等Unicode字符可正确处理

解决问题

1. 无法找到数据时：

- --data_path 请选择选项以指定确切路径。 - 脚本会自动搜索多个目录，但直接指定会更可靠。

1. 如果无法连接到Clode桌面：

- 请查看日志： tail -n 20 -F ~/Library/Logs/Claude/mcp*.log - claude_desktop_config.json 请确认文件是否位于正确的位置。

1. 未连接到Sumidare的情况：

- 请查看Sudbury日志。 - smithery.yaml 请确保文件已正确设置。

许可证

这个项目可以自由使用。

资源列表路由 def handle_resources_list(): 返回 {"资源": \[\]}

@mcp.route("提示/列表") def handle_prompts_list(): 返回 {"提示": \[\]}

@mcp.route("调试/状态") def debug_status(): return { "loaded_data": len(stylebook_data),， "server_uptime": "服务器运行时间：..."， "memory_usage": "内存使用量：……" }