Fortnox MCP服务器
用于探索Fortnox API文档的模型上下文协议（MCP）服务器。提供 377 Fortnox API端点 来自官方OpenAPI规范的文档。
概述
- 仅文档服务器 -提供API端点信息，不进行API调用
- 377 Fortnox API端点 来自官方OpenAPI 3.0规范
- 7个MCP工具 用于探索API文档
- 无需认证 -纯文档浏览
- AI优化 采用结构化markdown格式的响应
安装
npm install -g fortnox-doc-mcp或与 npx:
npx fortnox-doc-mcp可用工具
- get_api_overview -获取API概述、统计信息和推荐的工作流程
- list_all_endpoints -浏览所有Fortnox API端点（带可选过滤器）
- get_endpoint_details -获取特定端点的完整文档
- get_endpoints_by_resource -获取按操作分组的资源的所有端点
- search_endpoints -按关键字搜索端点
- list_resource_groups -列出所有81个API资源类别
- get_schema_details -查看数据模型架构
快速开始
适用于克劳德桌面
添加到您的Claude Desktop配置文件中：
窗户： %APPDATA%\Claude\claude_desktop_config.json\ 雨衣： ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"fortnox-docs": {
"command": "npx",
"args": ["-y", "fortnox-doc-mcp"]
}
}
}重新启动Claude Desktop以访问工具。
对于其他MCP客户端
{
"servers": {
"fortnox-doc-mcp": {
"type": "stdio",
"command": "npx",
"args": ["-y", "fortnox-doc-mcp"]
}
}
}使用示例
配置后，您可以询问AI助手：
- *“给我一个Fortnox API的概述”* → Uses
get_api_overview - *“列出所有Fortnox客户端点”* → Uses
get_endpoints_by_resource - *“显示GET/3/客户的详细信息”* → Uses
get_endpoint_details - *“搜索发票端点”* → Uses
search_endpoints - *“有哪些可用的资源组？”* → Uses
list_resource_groups - *“显示客户架构”* → Uses
get_schema_details
发展
来源
# Clone repository
git clone https://github.com/yourusername/fortnox-doc-mcp.git
cd fortnox-doc-mcp
# Install dependencies
npm install
# Build
npm run build
# Test
npm test项目结构
fortnox-doc-mcp/
├── src/
│ ├── index.ts # MCP server with 7 tools
│ ├── openapi-parser.ts # OpenAPI spec parser
│ └── test-docs.ts # Documentation test
├── openapi (1).json # Fortnox OpenAPI specification
└── dist/ # Compiled JavaScript技术细节
- OpenAPI版本: 3.0.3
- 端点：377 Fortnox API端点
- 资源组：81个类别
- 加载中：单例模式（一次性加载到内存中）
- 演出：O（1）端点查找，无外部API调用
- 节点版本: 18+
常见问题解答
Q： 我需要Fortnox API代币吗？\ A： 不！这是一个文档服务器。不需要API凭据。
Q： 这能让API调用Fortnox吗？\ A： 不是。它只提供OpenAPI规范中关于端点的文档。
Q： 如何在Claude Desktop中使用此功能？\ A： 将配置添加到 claude_desktop_config.json 并重新启动克劳德桌面。
Q： 我可以用它来构建Fortnox集成吗？\ A： 是的！在构建集成之前，使用它可以浏览API文档，了解端点、参数和架构。
许可证
麻省理工学院
链接
-