{"_id":"@apitable/aitable-mcp-server","_rev":"3-6dbb1be3be8179a232242eae1a84ee95","name":"@apitable/aitable-mcp-server","dist-tags":{"latest":"1.0.3"},"versions":{"1.0.1":{"name":"@apitable/aitable-mcp-server","version":"1.0.1","keywords":["AITable","MCP","Model Context Protocol","AI agents","datasheets"],"author":{"name":"AITable.ai"},"license":"MIT","_id":"@apitable/aitable-mcp-server@1.0.1","maintainers":[{"name":"vika-apitable","email":"wangkailang@vikadata.com"},{"name":"wangkailang992","email":"wangkailang992@gmail.com"},{"name":"apitableinc","email":"devops@apitable.com"},{"name":"ifidea","email":"karma.pan@gmail.com"}],"contributors":[{"name":"Kelvin Poon","email":"kelvin@aitable.ai"}],"bin":{"aitable-mcp-server":"dist/index.js"},"dist":{"shasum":"75d3c4800a2b680c2ad8df538e95f45af34e6ad6","tarball":"https://registry.npmjs.org/@apitable/aitable-mcp-server/-/aitable-mcp-server-1.0.1.tgz","fileCount":6,"integrity":"sha512-LujVNC9jyfjBBNtSdOPikLP8OzT10NsYcXNue5LAQWnoR82NFFAy5JjLxWCHMnGc6RLfgT1GAcK2IYl/FObOnQ==","signatures":[{"sig":"MEUCIGcFGoSKm6/ayhTf8U7eweQNhccf3O/NKw/Nl2bet3i1AiEAmuBBmnm/4Bv0sqx889YPGKzXBnVq14USklDnvr8vVKg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29941},"main":"index.js","type":"module","module":"./src/index.ts","gitHead":"9cafe967399e950b55acd91685be22265dafdf5d","scripts":{"dev":"nodemon --watch src --ext ts --exec \"npm run build\"","build":"tsc && node -e \"require('fs').chmodSync('dist/index.js', '755')\""},"_npmUser":{"name":"apitableinc","actor":{"name":"apitableinc","type":"user","email":"devops@apitable.com"},"email":"devops@apitable.com"},"_npmVersion":"10.8.2","description":"AITable.ai Model Context Protocol Server enables AI agents to connect and work with AITable datasheets.","directories":{},"_nodeVersion":"18.20.8","dependencies":{"zod":"^3.25.67","node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.4","nodemon":"^3.1.9","typescript":"^5.8.3","@types/node":"^22.14.1"},"_npmOperationalInternal":{"tmp":"tmp/aitable-mcp-server_1.0.1_1751373094830_0.39951852297476953","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@apitable/aitable-mcp-server","version":"1.0.2","keywords":["AITable","MCP","Model Context Protocol","AI agents","datasheets"],"author":{"name":"AITable.ai"},"license":"MIT","_id":"@apitable/aitable-mcp-server@1.0.2","maintainers":[{"name":"vika-apitable","email":"wangkailang@vikadata.com"},{"name":"wangkailang992","email":"wangkailang992@gmail.com"},{"name":"apitableinc","email":"devops@apitable.com"},{"name":"ifidea","email":"karma.pan@gmail.com"}],"contributors":[{"name":"Kelvin Poon","email":"kelvin@aitable.ai"}],"bin":{"aitable-mcp-server":"dist/index.js"},"dist":{"shasum":"2631d393c959806cabb21cfa2fc6c928442c8d36","tarball":"https://registry.npmjs.org/@apitable/aitable-mcp-server/-/aitable-mcp-server-1.0.2.tgz","fileCount":6,"integrity":"sha512-xnvILYvgwStg4t7L6IDMldx5UMQRMc+7sY1gM29nnt1+dVao1Eij9H/PawhCzdMFTxW0jwI1L8Zy6bAo1+dvhA==","signatures":[{"sig":"MEYCIQD3K2B+hqTJmSAAp8Jpkok4nv5JK5duxKFG365DaFjtUAIhAPqhF4snHDeOKTGU7uc024S3wZ1Cs+wTSW50TBmDlgoG","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29873},"main":"index.js","type":"module","module":"./src/index.ts","gitHead":"b05e9f3233875049ccfa45ddbcde2dd2d4bb1fe6","scripts":{"dev":"nodemon --watch src --ext ts --exec \"npm run build\"","build":"tsc && node -e \"require('fs').chmodSync('dist/index.js', '755')\"","prepare":"npm run build"},"_npmUser":{"name":"apitableinc","actor":{"name":"apitableinc","type":"user","email":"devops@apitable.com"},"email":"devops@apitable.com"},"_npmVersion":"10.8.2","description":"AITable.ai Model Context Protocol Server enables AI agents to connect and work with AITable datasheets.","directories":{},"_nodeVersion":"18.20.8","dependencies":{"zod":"^3.25.67","node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.4","nodemon":"^3.1.9","typescript":"^5.8.3","@types/node":"^22.14.1"},"_npmOperationalInternal":{"tmp":"tmp/aitable-mcp-server_1.0.2_1751433160657_0.8736819126975461","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@apitable/aitable-mcp-server","version":"1.0.3","description":"AITable.ai Model Context Protocol Server enables AI agents to connect and work with AITable datasheets.","keywords":["AITable","MCP","Model Context Protocol","AI agents","datasheets"],"main":"index.js","module":"./src/index.ts","type":"module","bin":{"aitable-mcp-server":"dist/index.js"},"scripts":{"prepare":"npm run build","build":"tsc && node -e \"require('fs').chmodSync('dist/index.js', '755')\"","dev":"nodemon --watch src --ext ts --exec \"npm run build\""},"author":{"name":"AITable.ai"},"contributors":[{"name":"Kelvin Poon","email":"kelvin@aitable.ai"}],"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","node-fetch":"^3.3.2","zod":"^3.25.67"},"devDependencies":{"@types/node":"^22.14.1","nodemon":"^3.1.9","tsx":"^4.19.4","typescript":"^5.8.3"},"_id":"@apitable/aitable-mcp-server@1.0.3","gitHead":"0db703e3759d324307888e87b625caf6949ae402","_nodeVersion":"18.20.8","_npmVersion":"10.8.2","dist":{"integrity":"sha512-YadUdSa74EutCJT3yHBgO9C/V9YOx7X4FHjHBlZsK5shtkbNxh2yfRL7O9wkKgS89oKAWSwNLxeQs2qZ3Yobwg==","shasum":"91c77da7582cfd956515896caebae5c06d9cc764","tarball":"https://registry.npmjs.org/@apitable/aitable-mcp-server/-/aitable-mcp-server-1.0.3.tgz","fileCount":6,"unpackedSize":30084,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBDhdOjgTzUI6WdSbcfvdPGpbuPjvPU9xe8sqNhznIc2AiBUxIS2szAwT6IqzQqhoFfnMT8GM1k131kXnmzCPLcvVQ=="}]},"_npmUser":{"name":"apitableinc","email":"devops@apitable.com","actor":{"name":"apitableinc","email":"devops@apitable.com","type":"user"}},"directories":{},"maintainers":[{"name":"vika-apitable","email":"wangkailang@vikadata.com"},{"name":"wangkailang992","email":"wangkailang992@gmail.com"},{"name":"apitableinc","email":"devops@apitable.com"},{"name":"ifidea","email":"karma.pan@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/aitable-mcp-server_1.0.3_1751594289271_0.5038209696256821"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-01T12:31:34.593Z","modified":"2025-07-04T01:58:09.680Z","1.0.1":"2025-07-01T12:31:35.090Z","1.0.2":"2025-07-02T05:12:40.891Z","1.0.3":"2025-07-04T01:58:09.448Z"},"author":{"name":"AITable.ai"},"license":"MIT","keywords":["AITable","MCP","Model Context Protocol","AI agents","datasheets"],"description":"AITable.ai Model Context Protocol Server enables AI agents to connect and work with AITable datasheets.","contributors":[{"name":"Kelvin Poon","email":"kelvin@aitable.ai"}],"maintainers":[{"name":"vika-apitable","email":"wangkailang@vikadata.com"},{"name":"wangkailang992","email":"wangkailang992@gmail.com"},{"name":"apitableinc","email":"devops@apitable.com"},{"name":"ifidea","email":"karma.pan@gmail.com"}],"readme":"# AITable MCP Server\n\nA Model Context Protocol server that provides read and write access to [AITable.ai](https://aitable.ai). This server enables LLMs to list spaces, search nodes, list records, create records and upload attachments in AITable.ai.\n\n\n \"AITable\n\n\n## Tools\n\n| Tool Name | Availabe | Description |\n| ------------------------- | -------- | ------------------------------------------------------------------------------------------------------------- |\n| list_spaces | ✅ | Fetches all workspaces that the currently authenticated user has permission to access. |\n| search_nodes | ✅ | Retrieve nodes based on specific types, permissions, and queries. |\n| list_records | ✅ | Read the records from a specified database with support for pagination, field filtering, and sorting options. |\n| get_fields_schema | ✅ | Returns the JSON schema of all fields within the specified database |\n| create_record | ✅ | Create a new record in the database. |\n| upload_attachment_via_url | ✅ | Upload an attachment to the AITable server using its web URL. |\n| update_record | ❌ | TODO |\n\n## Environment Variables\n\n- `AITABLE_API_KEY`: Your AITable personal access token.\n- `AITABLE_BASE_URL`: The base URL of the AITable API. Defaults to `https://aitable.ai/fusion`. You can set it to `{YOUR_CUSTOM_BASE_URL}` if you are using the APITable(the open-source version of AITable).\n\n## Usage\n\nYou can use this server in MCP client such as [Claude Desktop](https://claude.ai/download), [CherryStudio](https://www.cherry-ai.com/), etc.\n\n**Claude Desktop**\nIn the case of Claude Desktop, you need to add the following configuration information to the \"mcpServers\" section of the `claude_desktop_config.json` file:\n\nFor Linux, MacOS:\n\n```json\n{\n \"mcpServers\": {\n \"aitable\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"/ABSOLUTE/PATH/TO/PARENT/FOLDER/aitable-mcp-server\"\n ],\n \"env\": {\n \"AITABLE_API_KEY\": \"YOUR_API_KEY\"\n }\n }\n }\n}\n```\n\nFor Windows:\n\n```json\n{\n \"mcpServers\": {\n \"aitable\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"D:\\\\ABSOLUTE\\\\PATH\\\\TO\\\\PARENT\\\\FOLDER\\\\aitable-mcp-server\"\n ],\n \"env\": {\n \"AITABLE_API_KEY\": \"YOUR_API_KEY\"\n }\n }\n }\n}\n```\n\nReplace `YOUR_API_KEY` with your AITable personal access token and `/ABSOLUTE/PATH/TO/PARENT/FOLDER/aitable-mcp-server` with the absolute path to the parent folder of this repository.\n\n**CherryStudio**\nIf you are using the CherryStudio as MCP client and Windows system, your configuration should look like this:\n\n```json\n{\n \"mcpServers\": {\n \"aitable\": {\n \"command\": \"cmd\",\n \"args\": [\n \"/c\",\n \"npx\",\n \"-y\",\n \"D:\\\\ABSOLUTE\\\\PATH\\\\TO\\\\PARENT\\\\FOLDER\\\\aitable-mcp-server\"\n ],\n \"env\": {\n \"AITABLE_API_KEY\": \"YOUR_API_KEY\"\n }\n }\n }\n}\n```\n\n## Debug\n\nThe [MCP inspector](https://github.com/modelcontextprotocol/inspector) is a developer tool for testing and debugging MCP servers.\n\nTo inspect an MCP server implementation, there's no need to clone the MCP inspector repo. Instead, use `npx`. For example, AITable MCP server is built at `dist/index.js`. Arguments are passed directly to your server, while environment variables can be set using the `-e` flag:\n\n```bash\nnpx @modelcontextprotocol/inspector -e AITABLE_API_KEY={YOUR_API_KEY} node build/index.js\n```\n\nThe other way is to clone the MCP inspector repo and connect the AITable MCP server in the inspector interface.\n\n```bash\ncd path/to/inspector/\nnpm start -- -e AITABLE_API_KEY={YOUR_API_KEY}\n```","readmeFilename":"README.md"}