{"id":23980299,"url":"https://github.com/hmk/box-mcp-server","last_synced_at":"2025-11-13T01:00:59.395Z","repository":{"id":270413550,"uuid":"910315522","full_name":"hmk/box-mcp-server","owner":"hmk","description":"A Box model context protocol server to search, read and access files","archived":false,"fork":false,"pushed_at":"2025-08-22T14:46:26.000Z","size":220,"stargazers_count":10,"open_issues_count":2,"forks_count":9,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-13T12:36:56.444Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hmk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-12-31T00:49:10.000Z","updated_at":"2025-08-28T08:58:29.000Z","dependencies_parsed_at":"2025-08-22T16:23:23.086Z","dependency_job_id":"c0749746-aeb7-4033-ba70-0df6151ad18b","html_url":"https://github.com/hmk/box-mcp-server","commit_stats":null,"previous_names":["hmk/box-mcp-server"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/hmk/box-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmk%2Fbox-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmk%2Fbox-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmk%2Fbox-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmk%2Fbox-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hmk","download_url":"https://codeload.github.com/hmk/box-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmk%2Fbox-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":284134778,"owners_count":26953118,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-11-12T02:00:06.336Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-07T10:01:20.511Z","updated_at":"2025-11-13T01:00:59.353Z","avatar_url":"https://github.com/hmk.png","language":"JavaScript","readme":"# box-mcp-server\n\n![CI](https://github.com/hmk/box-mcp-server/actions/workflows/jest.yml/badge.svg?branch=main)\n\n## Usage\n\nYou will need:\n\n- `BOX_USER_ID` \n\nand one of the following:\n\n- `BOX_JWT_BASE64` (recommended)\n- `BOX_JWT_CONFIG_PATH`\n- `BOX_JWT`\n\n## Auth\n\n### JSON Web Token (JWT) Authorization (recommended)\n\n#### How to get a JWT\n\nUsing a JWT Config allows persistent connection to Box.\n\n\nYou will need a paid Box enterprise account, or you can sign up for a [free developer account](https://account.box.com/signup/n/developer) (make sure you are signed out of Box before clicking that link).\n\nVisit the [Box Developer Console](https://app.box.com/developers/console) and create a new application. Make sure the authorization type is JSON Web Token.\n\nGo to `Configuration \u003e Add and Manage Public Keys` and Generate a Public/Private Keypair.\nIf you have not already, Box prompt you to set up 2 factor authentication and Authorize the application as an administrator in your box account. You will need to:\n\n1. give the application `App + Enterprise Access`, and\n2. enable the `make API calls using the as-user header` option\n\nvia the Box Application's Configuration page. **Make sure to reauthorize the application if you are modifying these settings**.\n\n#### Base64 encoding JWT\n\nTo encode your JWT in Base64, you can use the following command in your terminal:\n\n```sh\ncat /path/to/your/box-jwt-config.json | base64\n```\n\nReplace `/path/to/your/box-jwt-config.json` with the actual path to your JWT configuration file. This will output the Base64 encoded JWT which you can then use in your environment variables.\n\n#### Claude Desktop Configuration\n\n```json\n{\n  \"mcpServers\": {\n    \"box\": {\n      \"command\": \"npx\",\n      \"args\": [\"box-mcp-server\"],\n      \"env\": {\n        \"BOX_JWT_BASE64\": \"YOUR_BASE64_ENCODED_JWT\",\n        \"BOX_USER_ID\": \"123456\"\n      }\n    }\n  }\n}\n```\n\n### Developer Token Authorization (easiest)\n\nUsing a developer token is the easiest way to integrate with Box, but will only last 60 minutes.\n\nTo get started, set the `BOX_DEV_TOKEN` to a [Box Developer Token](https://developer.box.com/guides/authentication/tokens/developer-tokens/).\n\nBegin by visiting the [Box Developer Console](https://app.box.com/developers/console) and create a new application. The authorization type does not currently matter, as all support Box Developer Token.\n\nOnce your application is created, navigate to its configuration setings and click `Generate Developer Token`.\n\n#### Claude Desktop Configuration\n\n```json\n{\n  \"mcpServers\": {\n    \"box\": {\n      \"command\": \"npx\",\n      \"args\": [\"box-mcp-server\"],\n      \"env\": {\n        \"BOX_DEV_TOKEN\": \"YOUR_DEV_TOKEN_GOES_HERE\"\n      }\n    }\n  }\n}\n```\n\n## Capabilities\n\n1. Searching files\n2. Reading files\n\n- [x] PDF\n- [x] Word\n- [ ] Others\n\n## Development\n\n### Prerequisites\n\nBefore you begin, ensure you have the following installed:\n\n- Node.js (recommended v22 or higher)\n- npm\n- git\n- dotenv\n\n### Setting up Development Environment\n\nTo set up the development environment, follow these steps:\n\n1. Fork the repository\n\n   - Click the \"Fork\" button in the top-right corner of this repository\n   - This creates your own copy of the repository under your Github acocunt\n\n1. Clone Your Fork:\n\n   ```sh\n   git clone https://github.com/YOUR_USERNAME/box-mcp-server.git\n   cd box-mcp-server\n   ```\n\n1. Add Upstream Remote\n   ```sh\n   git remote add upstream https://github.com/hmk/box-mcp-server.git\n   ```\n\n1. Copy the dotenv file\n    ```sh\n    cp .env.template .env\n    ```\n\n1. Install dependencies:\n\n   ```sh\n   npm install\n   ```\n\n1. Run watch to keep index.js updated:\n\n   ```sh\n   npm run watch\n   ```\n\n1. Start the model context protocol development server:\n\n   ```sh\n   dotenv npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js\n   ```\n\n1. If the development server did not load the environment variable correctly, set the `BOX_DEV_TOKEN` on the left-hand side of the mcp inspector.\n","funding_links":[],"categories":["File Management MCP Servers","MCP 服务器精选列表","Legend","پیاده‌سازی‌های سرور","Cloud Storage","Community Servers","Cloud Platforms","Cloud Services","🌐 Web Development","Uncategorized","Table of Contents"],"sub_categories":["📁 文件系统与存储","📂 \u003ca name=\"file-systems\"\u003e\u003c/a\u003eFile Systems","📂 \u003ca name=\"file-systems\"\u003e\u003c/a\u003eسیستم‌های فایل","How to Submit","Uncategorized","Other Tools and Integrations"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhmk%2Fbox-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhmk%2Fbox-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhmk%2Fbox-mcp-server/lists"}